Suggestions on documentation improvements
Well, to be exact, in this case those params aren't the next. Again we are victims of copy-paste ;-)
WinTitle: If this and the next 3 parameters are omitted, the Last Found Window will be used. If this is the letter A and the next 3 parameters are omitted, the active window will be used.
<!-- m -->http://www.autohotke...ds/SetTimer.htm<!-- m -->
"If you wish the timer's first first execution to be immediate..."
BTW I just love to RTFM, really, Autohotkey has one of the best documentations one can wish, I especially value the examples very high!
On the page <!-- m -->http://www.autohotke...s/Variables.htm<!-- m -->
in the A_EventInfo section there is a Note. I think it should be outside of the table cell, as it does not refer to A_EventInfo only.
Two notes I took when first reading the doc. (I omit the Gosub/Exit already reported):
Script section, "Comments in Scripts": "Tip: The first comma of any command may be omitted. "
I don't feel this tip belongs to comments... I suggest you put this tip in the Tutorial section, since you first use this syntax here and I was a bit confused to see MsgBox without initial comma unlike the previous examples...
AutoScriptWriter is mentioned twice in the doc, but not much information is given on how to use it.
I understand that it is a third party software, and finally rather simple to use, but a link to a page with a few words on its usage could help. I was perplexed until I found out that the red logo is an actual button...
You're right, I never liked it there. I've moved it to Escape Sequences (on the same page) where it seems to fit better. I've also added it to the Quick-start Tutorial, but changed most of the tutorial to omit the first comma so that new users get used to the convenience. Thanks.
"Tip: The first comma of any command may be omitted."
I don't feel this tip belongs to comments
Some documentation of that is planned. I've made a note to explain the button better. Thanks.
AutoScriptWriter ... not much information is given on how to use it.
I was perplexed until I found out that the red logo is an actual button...
Unmodifiable text with no border
After testing, I saw that is not exactly true on the "Unmodifiable" side (even if I understand that the sense is to oppose it to Edit): you can use ControlSetText to change the text. Or, as toralf pointed out, the more appropriate GuiControl command.
It is nicer than using a read-only Edit control, I often use such thingies to display debug data...
Perhaps you can add a line about this in this paragraph or change slightly the wording.
Also, the GuiControl page should include the Text control in the (Blank) and Text sub-commands.
2) Why If[Not]InString isn't in the Flow of Control section? There is a link to this command in the If page, but it is near the bottom, and one can miss it in a quick glance (I did... "Mumble... I recall something like that, where can it be? Mumble..." :-P).
I would include in the yellow list, I see not reason why it isn't there.
Perhaps this thread should be renamed, or perhaps I should start one of my own ;-)
1) PostMessage / SendMessage has a convenient link to the message list.
OnMessage hasn't, at least, not on the MsgNumber description.
It would be nice to add one, since I am not able to locate this page in the Summary tab of the CHM file.
2) SysGet: "Within a function, to create an set of variables"