*/
    void comment(String comment);

The details of the syntax are documented at https://go.dev/doc/comment.

To parse the text associated with a doc comment (after removing comment markers),
use a [Parser]:

	var p comment.Parser
	doc := p.Parse(text)

The result is a [*Doc].
To reformat it as a doc comment, HTML, Markdown, or plain text,
use a [Printer]:

	var pr comment.Printer
	os.Stdout.Write(pr.Text(doc))

func issue5623() {
L:
	_ = yyyyyyyyyyyyyyyy			// comment - should be aligned
	_ = xxxxxxxxxxxxxxxxxxxxxxxxxxxx	/* comment */

	_ = yyyyyyyyyyyyyyyy			/* comment - should be aligned */
	_ = xxxxxxxxxxxxxxxxxxxxxxxxxxxx	// comment

LLLLLLL:
	_ = yyyyyyyyyyyyyyyy			// comment - should be aligned
	_ = xxxxxxxxxxxxxxxxxxxxxxxxxxxx	// comment

LL:
LLLLL:
	_ = xxxxxxxxxxxxxxxxxxxxxxxxxxxx	/* comment */

// []Error lists in a map indexed by line number. The comment text is
// the comment with any comment markers ("//", "/*", or "*/") stripped.
// The position for each Error is the position of the token immediately
// preceding the comment and the Error message is the comment text,
// with all comments that are on the same line collected in a slice, in
// source order. If there is no preceding token (the matching comment

The remaining files contain the expected output for the named format generated by
[comment.Printer](https://pkg.go.dev/go/doc/comment/#Printer):
“gofmt” for Printer.Comment (Go comment format, as used by gofmt),
“html” for Printer.HTML, “markdown” for Printer.Markdown, and “text” for Printer.Text.
The format can also be “dump” for a textual dump of the raw data structures.

			{Comma: ',', Comment: '#'},
			{Comma: ',', Comment: ';'},
		} {
			t.Logf("With options:")
			t.Logf("  Comma            = %q", tt.Comma)
			t.Logf("  LazyQuotes       = %t", tt.LazyQuotes)
			t.Logf("  TrimLeadingSpace = %t", tt.TrimLeadingSpace)
			t.Logf("  Comment          = %q", tt.Comment)
			r := NewReader(bytes.NewReader(in))
			r.Comma = tt.Comma
			r.Comment = tt.Comment
			r.LazyQuotes = tt.LazyQuotes

    }

    def "empty properties with comment are written properly"() {
        expect:
        write([:], "Line comment") == normalize("""
            #Line comment
            """)
    }

    def "simple properties are written sorted alphabetically"() {
        expect:
        write([one: "1", two: "2", three: "three"], "Line comment") == normalize("""
            #Line comment
            one=1
            three=three

         *
         * See [PropertiesUtils.store].
         */
        fun store(data: Map<String, Any>, file: File, comment: String? = null) {
            store(propertiesFrom(data), file, comment)
        }

        /**
         * Writes [Properties] to a file, but without including the timestamp comment.
         *
         * See [PropertiesUtils.store].

// in a Go program while maintaining correct comment association
// using an ast.CommentMap.
func ExampleCommentMap() {
	// src is the input for which we create the AST that we
	// are going to manipulate.
	src := `
// This is the package comment.
package main

// This comment is associated with the hello constant.
const hello = "Hello, World!" // line comment 1

// This comment is associated with the foo variable.

package p

... `, false},
		// Special comment has rogue interior space.
		{`//     Code generated by gen. DO NOT EDIT.
package p
`, false},
		// Special comment lacks the middle portion.
		{`// Code generated DO NOT EDIT.
package p
`, false},
		// Special comment (incl. "//") appears within a /* block */ comment,
		// an obscure corner case of the spec.
		{`/* start of a general comment