diff options
author | Ingo Schwarze <schwarze@openbsd.org> | 2022-07-06 14:34:59 +0000 |
---|---|---|
committer | Ingo Schwarze <schwarze@openbsd.org> | 2022-07-06 14:34:59 +0000 |
commit | c1c1046eb88a69d9f559370b1d521af13b115110 (patch) | |
tree | d5db61a11aade956ff801859e895be141c97546b /regress/mdoc/Sh | |
parent | a9e960d078e665ba7f3e3a6dfd0e976d1635ee84 (diff) | |
download | mandoc-c1c1046eb88a69d9f559370b1d521af13b115110.tar.gz |
While the HTML standard allows multiple <h1> elements in the same
document, <h1> is intended for top level headers, and most of the
sections in a manual page can hardly be considered top-level.
It is more usual to use <h1> only for the main title of the document
of for the site name.
Consequently, move .Sh/.SH from <h1> to <h2> and .Ss/.SS from <h2>
to <h3>, freeing <h1> for use by header.html in man.cgi(8).
Discussed with Anna Vyalkova <cyber at sysrq dot in>.
Diffstat (limited to 'regress/mdoc/Sh')
-rw-r--r-- | regress/mdoc/Sh/paragraph.out_html | 4 | ||||
-rw-r--r-- | regress/mdoc/Sh/tag.out_html | 14 |
2 files changed, 9 insertions, 9 deletions
diff --git a/regress/mdoc/Sh/paragraph.out_html b/regress/mdoc/Sh/paragraph.out_html index 82ede5be..7dc93653 100644 --- a/regress/mdoc/Sh/paragraph.out_html +++ b/regress/mdoc/Sh/paragraph.out_html @@ -1,9 +1,9 @@ <p class="Pp">descriptive text</p> <section class="Ss"> -<h2 class="Ss" id="Subsection"><a class="permalink" href="#Subsection">Subsection</a></h2> +<h3 class="Ss" id="Subsection"><a class="permalink" href="#Subsection">Subsection</a></h3> <p class="Pp">initial subsection text</p> <p class="Pp">subsection paragraph</p> </section> </section> <section class="Sh"> -<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1> +<h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2> diff --git a/regress/mdoc/Sh/tag.out_html b/regress/mdoc/Sh/tag.out_html index 0dd39398..94332652 100644 --- a/regress/mdoc/Sh/tag.out_html +++ b/regress/mdoc/Sh/tag.out_html @@ -2,26 +2,26 @@ </section> </section> <section class="Sh"> -<h1 class="Sh" id="DESCRIPTION~2"><a class="permalink" href="#DESCRIPTION~2">DESCRIPTION</a></h1> +<h2 class="Sh" id="DESCRIPTION~2"><a class="permalink" href="#DESCRIPTION~2">DESCRIPTION</a></h2> <p class="Pp">Text in duplicate description section.</p> </section> <section class="Sh"> -<h1 class="Sh" id="examples"><a class="permalink" href="#examples">EXAMPLES</a></h1> +<h2 class="Sh" id="examples"><a class="permalink" href="#examples">EXAMPLES</a></h2> <p class="Pp">Text introducing examples.</p> <section class="Ss"> -<h2 class="Ss" id="example"><a class="permalink" href="#example">Subsection</a></h2> +<h3 class="Ss" id="example"><a class="permalink" href="#example">Subsection</a></h3> <p class="Pp">Example text.</p> </section> <section class="Ss"> -<h2 class="Ss" id="Sub-section"><a class="permalink" href="#Sub-section">Sub-section</a></h2> +<h3 class="Ss" id="Sub-section"><a class="permalink" href="#Sub-section">Sub-section</a></h3> <p class="Pp">More example text.</p> </section> </section> <section class="Sh"> -<h1 class="Sh" id="WEIRD_SECTION"><a class="permalink" href="#WEIRD_SECTION"> - WEIRD SECTION </a></h1> +<h2 class="Sh" id="WEIRD_SECTION"><a class="permalink" href="#WEIRD_SECTION"> + WEIRD SECTION </a></h2> <p class="Pp">Text in weird section.</p> </section> <section class="Sh"> -<h1 class="Sh"> </h1> +<h2 class="Sh"> </h2> <p class="Pp">Text in section with empty header.</p> |