tree f5fc5c8d933cd9c86659e171cf5d8e394400f77d
parent d5f37122d2235630aad5a67ec45f7d6976c4f2ed
author Volker Dobler <dr.volker.dobler@gmail.com> 1322761798 -0800
committer Robert Griesemer <gri@golang.org> 1322761798 -0800
golang-hg deeec5c15f88529f49dc148ed352ce287413e4af

go/doc: Detect headings in comments and format them as h3 in html.

To structure larger sections of comments in html output headings
are detected in comments and formated as h3 in the generated html.
A simple heuristic is used to detect headings in comments:
A heading is a non-blank, non-indented line preceded by a blank
line. It is followed by a blank and a non-blank, non-indented line.
A heading must start with an uppercase letter and end with a letter,
digit or a colon.  A heading may not contain punctuation characters.

R=jan.mercl, gri, adg, rsc, r
CC=golang-dev
https://golang.org/cl/5437056