✨ Comment Styles

[tom-ludwig]

Description

Comment characters currently start before the first visible character. In Xcode they are instead of at the beginning of a line. Users may prefer one commenting style over the other. We should provide a setting to toggle between these two commenting styles.

Setting Option

Name: Comment style

Options:

• At beginning of line (default)
• After leading whitespace

Note

The current behavior is "After leading whitespace" but there is no space after the comment characters. We should include this space. If multiple lines are commented out, comments should be at the same tab level.

At beginning of line

Single line

func add(a, b) {
    func result(a, b) {
//        return a + b
    }
    return result(a, b)
}

Multi line

func add(a, b) {
//    func result(a, b) {
//        return a + b
//    }
    return result(a, b)
}

After leading whitespace

Single line

func add(a, b) {
    func result(a, b) {
        // return a + b
    }
    return result(a, b)
}

Multi line

func add(a, b) {
    // func result(a, b) {
    //     return a + b
    // }
    return result(a, b)
}