SciTE question: are bold headings feasible?

[qwert 42]

Right off the bat, let me ask that anyone responding to refrain from:  1) asking me why in the world I would want these bolder lines ... and 2) suggesting that I use #cs/#ce, which I have already found to be an inadequate substitute for what I envision.  I'm looking for brand new capability from SciTE.  So here's the proposition:

I think I’m close to having an SciTE feature that I’ve wanted for years: 

Bolded Headings ... as "special" comments that have a display style separate from regular comments.

For example:

;HS =========== a bolded header  =============
        Sleep(1000)                                ; a bolded script statement, if possible ... but this isn't absolutely necessary
;HE ========== another bolded line ============

As I looked at SciTE’s generic properities parameter definitions, I saw that comment.stream is basically disabled by having it equated to the #cs/#ce comment.box(block) that we’re familiar with.  It looks to me like “stream” comments could be independent ... at least in the limited way I want.

As a test, I picked ;HS and ;HS as the trigger strings ... and then edited the properties files in obvious places.*

It did not work.  So things are not as forthright as they appeared ... although I see SciTE configured in many ways for different languages.

So my question is: is this really feasible for SciTE?  If so, what is the “third rail” of the mechanism ... the part that I’m obviously missing?

Thanks in advance for any help from an SciTE Expert!

* The reason they start with a semicolon is so that all Au3 processing will treat them as simple comments.  I’m only looking for SciTE to display them in a different style.

 

 

Edited May 15, 2015 by qwert

[Jos 2,164]

What you are looking for is not that easy as it sounds for the simple fact that what you want is overide the settings for each of the defined Lexer options and make sure their are showing a Bold version of these settings.

As I am not allowed to ask why you want this under your rule 1, so I will refrain from asking this question and going to wish you luck in your endeavour.
Let me know when you have a rounded proposal.

Jos

Edited May 15, 2015 by Jos

[guinness 1,517]

Having a different colour is enough! In the IDEs I use i don't have comment blocks set to be bold.

[qwert 42]

Jos, just a quick clarification:

you want is overide the settings for each of the defined Lexer options and make sure their are showing a Bold version of these settings

I was thinking of a simpler approach: hard code the font and weight into the properties for the comment.stream elements.  I'm willing to work with a static "feature" and keep the properties editor just as it is.

Is that a "rounded proposal"?  (I'm not familiar with the term.)

[Jos 2,164]

Maybe I am not totally understanding it yet:
Not sure why you would need a ;HS and ;HE when you only what the line starting with this option should be bold.

Jos

 

[qwert 42]

The pairing was just to make use of the already-existing comment.stream parameters.  I was going for a minimalist implementation.  But a bonus would have been if any bracketed lines took on the header font and bold look.

I can certainly live with a one-shot trigger that would affect a single line and keep this strictly for "special" comments.  My assumption is that it would have to start with ";" in order to avoid Au3 complications ... so something like ";H" could be the trigger.

[czardas 1,269]

I don't agree that ';H' should be a trigger because it takes away the option of a normal commented ';H'. Why a bold comment is so important to you I'm unsure. It has some aesthetic value, but that seems to be about all it has.

Edited May 18, 2015 by czardas

[qwert 42]

I really didn't think I would need to explain why another style of comment would be worthwhile, but let me offer this example of use:

Consider the chapters of a book ... and how the table of contents emphasizes each chapter apart from other material.  In much the same way, scripts of any length have Sections ... like Initialization ... GUI Definition ... Processing ... Supporting Functions ... etc.

I want the section headings of my scripts to stand out clearly.  A larger font ... maybe bolded ... maybe colored ... will do that.  In fact, I find it difficult to believe that after 30 years of refinement of source code editors that this isn't a standard feature.  

Regarding the ;H, it was just a placeholder choice to get this going.  I was probably going to change it to something like ;: or ;= for my own use.

Anyway, that's the backstory.  The reason I even started exploring this was the following note in an SciTE help site:

You can set up comment formats for a language and use the Block, Box or Stream Comment functions from the menu to automatically generate symbols that denote comments for a particular language. Below is an example for HTML comments.

comment.box.start.hypertext=<!--

comment.box.middle.hypertext=

comment.box.end.hypertext= -->

I still think Header Comments are feasible and worth doing.  But, working on my own, it may take me a while.

 

[jchd 1,506]

You seem to be confusing a programming language source code editor with LaTeX2e output.

[qwert 42]

I don't see it that way at all.  It's like the difference between editing a text document with NotePad or WordPad. 

SciTE has 50 features for visually enhancing the character strings of the source code.

All I'm looking for is Feature #51.

 

[jchd 1,506]

Then why not ask SciTE devs?

[czardas 1,269]

The way I see it is that comments are like a necessary evil: they (should really) have no influence on the code but a language needs to incorporate them into its syntax. How different elements within the code are displayed by an editor is a different concern, and I also understand the desire for greater flexibility. A relevant question would be - how much of a language's syntax resources should be devoted to creating complexity within comments?

Edited May 18, 2015 by czardas

[qwert 42]

You can set up comment formats for a language and use the Block, Box or Stream Comment functions from the menu to automatically generate symbols that denote comments for a particular language. Below is an example for HTML comments.

comment.box.start.hypertext=<!--

comment.box.middle.hypertext=

comment.box.end.hypertext= -->

Again, SciTE seems built (with forethought) to handle just this kind of thing (more than one style of comment).

I'm just trying to decipher the related parameters and constructs.  Au3 properties has box comments and stream comments equated, both to #cs/#ce.  My minimum implementation would be:

1.  hard code the font and weight into the properties for the comment.stream elements.

2.  define a trigger character pair ( something like ;= ) to cause SciTE to display a line as a stream comment

That's it.

[Zip 0]

If I get what you ask, what you are looking for already exists, not sure why no one mentioned it.
you can use the Keyword '#Region' '#EndRegion' for this.
 

Edited June 6, 2015 by Zip

[Jos 2,164]

#Region-#EndRegion is really made to define sections of code which you can fold.
As to the OP's original request: A new AU3Lexer Style will have to be created and the logic will have to be made in LEXAU3.cxx to scan for this new Comment type and apply the new style to it.

Is it doable:Yes
Will I be working on it: Not until this would really serve a purpose for a larger group of people.

Jos

Edited June 6, 2015 by Jos

[qwert 42]

Thanks to everyone who has taken a look at this.

Jos is right, of course, about what it takes for a full implementation (I went to the well on this one and found the same definitive answer). I’d like to think that others will see the advantages of having a second style of comment lines and it can become a standard feature.

In the mean time, I’ve fashioned a solution that is working for me. I’m getting the kind of effect I wanted, with only a small distracting ‘artifact’ (unwanted “cs/ce” characters in the lines ... which are minor, all things considered).

I’ve attached a small section of a script that shows the effect.

If anyone is interested, I can post instructions in a few days.

 

 

[guinness 1,517]

I don't see how it adds value to what we already have.

[czardas 1,269]

I don't think it's such a bad idea, but I also don't think it is worth adding as a language feature. I don't know of other languages that differentiate between bold and normal code, in comments or otherwise. Such formatting can be done separately - not as a language feature - using various methods.

Edited June 9, 2015 by czardas

[JLogan3o13 1,621]

Looking at that code for a long period of time would make me    

Edited June 10, 2015 by JLogan3o13

[Jos 2,164]

I don't think it's such a bad idea, but I also don't think it is worth adding as a language feature. I don't know of other languages that differentiate between bold and normal code, in comments or otherwise. Such formatting can be done separately - not as a language feature - using various methods.

This request is more a Editor/Lexer feature than a AutoIt3 Language feature.

Just in general:
Actually adding it would be trivial and documenting it would be more work than updating the Lexer code, but I do not want to bloat the code with stuff that is never used by the majority of people. There are 2 Comment styles already for commentlines (;) and commentblocks (#CS - #CE) which is what you find in most languages and supported by most Editors.

Jos