Some background information: Commands vs Functions
I appreciate the arguments from both sides, and I think I better understand the perception that command syntax is easier for beginners. However, I think that in the long run, AutoHotkey is better off with more uniform syntax.
This is basically where I was headed when I started the above topic. I have been dissatisfied with v2, I think, since removing the "can be an expression" rule. I felt that it reduced the convenience of command syntax and deviated too far from Chris Mallett's creation, while simultaneously failing to really solve the underlying problems. Dissatisfaction, reluctance and indecision nearly caused me to abandon AutoHotkey. At this point, I feel much better about dropping command syntax than dropping AutoHotkey or continuing with command syntax.
Before making the decision, I spent considerable time writing more comprehensive (and central) documentation about the syntax, and about fundamental concepts that users are currently expected to learn by example (or already know). The idea was that it might bring me to a closer understanding of the problems with the syntax and how (or whether) to fix them, while also producing better documentation. (At the very least, it had the effect of renewing my motivation to do other things... ) It is very much unfinished, so not on GitHub yet. I intend to cover more topics, then review it thoroughly, reorganise it and integrate it with the v1 (and most of it with the v2) documentation. For interest, this is what I have so far (html generated from markdown documents):
AutoHotkey-Future or similar projects, or the documentation.
In retrospect, I think the documentation should have been revised years ago, in particular with regard to
var = valueand the various forms of IF statements, given that they were acknowledged by Chris as being the two biggest problems with AutoHotkey v1's syntax. But in general, my motivation to work on documentation beyond the minimum of new changes and corrections is pretty low.
I have also been reconsidering percent-sign derefs in quoted strings, as they were primarily an attempt at integrating the "legacy" syntax with expressions and bringing more consistency to the language. Though I'm reluctant to deviate from the v1 expression syntax, I think there are more readable alternatives for variable/expression substitution within strings.