Documentation
¶
Overview ¶
Package bug1595 reproduces go-swagger#1595: a swagger:operation written in a /* */ block comment must scan like its // equivalent.
Both annotations below are gofmt-clean (run gofmt and they don't change), so they exercise the forms real source actually takes:
- displayProduct uses the flush-left block style. gofmt rewrites the column-0 YAML body into its "code block" canonical form — a blank line under `responses:` and TAB-indented children. That form must still parse (the framing strip here composes with yaml.RemoveIndent's dedent/retab, 94ec08f). Do NOT "tidy" the tabs back to spaces: gofmt would just rewrite them again.
- displayWidget uses the *-decorated block style, which gofmt leaves as-is; it exercises the godoc `* ` continuation strip.
Click to show internal directories.
Click to hide internal directories.