Fix: Indent after oneCommandCode on comment, block comment, empty line. Formatting inside block comment.

[kyklish]

Closes #59.
Closes #185.

Changes proposed in this pull request:

• more universal search of begin /* and end */ block comment pattern
• extract save indented line code to buildIndentedLine(...) function
• don't reset oneCommandCode if current line is empty, single line comment or block comment
• save indent values on block comment enter and restore them on block comment exit
• add directives for formatter ;@AHK++FormatBlockCommentOn and ;@AHK++FormatBlockCommentOff to format code inside block comments
• add directives to snippets

In:

foo () {
;@AHK++FormatBlockCommentOn
/*
typedef struct TEST {
DWORD cbSize;          0
} CMINVOKECOMMANDINFOEX;
*/
/*
MsgBox, This line is commented out (disabled).
MsgBox, Common mistake: */ this does not end the comment.
MsgBox, This line is commented out. 
*/
/*
bar() {
Loop, 4 {
MsgBox % A_Index
}
if (true) {
SoundBeep
} else {
MsgBox
}
}
if (true)
ToolTip
MsgBox
*/
;@AHK++FormatBlockCommentOff
MsgBox
/*
    All text in this block comment must save original indent
bar() {
        Loop, 4 {
                MsgBox % A_Index
        }
}
*/
}

Out:

foo () {
    ;@AHK++FormatBlockCommentOn
    /*
    typedef struct TEST {
        DWORD cbSize;          0
    } CMINVOKECOMMANDINFOEX;
    */
    /*
    MsgBox, This line is commented out (disabled).
    MsgBox, Common mistake: */ this does not end the comment.
    MsgBox, This line is commented out. 
    */
    /*
    bar() {
        Loop, 4 {
            MsgBox % A_Index
        }
        if (true) {
            SoundBeep
        } else {
            MsgBox
        }
    }
    if (true)
        ToolTip
    MsgBox
    */
    ;@AHK++FormatBlockCommentOff
    MsgBox
    /*
        All text in this block comment must save original indent
    bar() {
            Loop, 4 {
                    MsgBox % A_Index
            }
    }
    */
}

Notifying @mark-wiemer

[mark-wiemer]

Thanks so much, this is great code! It'd be awesome if we could update the tests in this PR as well, please let me know if you have any questions.

[kyklish]

Who must press Resolve conversation on requested changes, when I commit requested changes?

[kyklish]

TODO
Will extract block comment formatting to separate PR and add formatter directive:
; @AHK++-FormatBlockComment [add it to snippets]

Feature directives for enable/disable trim spaces between words:
; @AHK++-TrimOn
; @AHK++-TrimOff

[kyklish]

Done.