![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Up to [cvsweb.bsd.lv] / mandoc / regress / mdoc / Sh
Up to [cvsweb.bsd.lv] / mandoc / regress / mdoc / Sh
Request diff between arbitrary revisions
Default branch: MAIN
Revision 1.5 / (download) - annotate - [select for diffs], Wed Jul 6 14:35:08 2022 UTC (3 years ago) by schwarze
Branch: MAIN
CVS Tags: HEAD
Changes since 1.4: +7 -7 lines
Diff to previous 1.4 (colored) to selected 1.2 (colored)
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>.
Revision 1.4 / (download) - annotate - [select for diffs], Mon Apr 20 13:07:28 2020 UTC (5 years, 2 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_6
Changes since 1.3: +1 -1 lines
Diff to previous 1.3 (colored) to selected 1.2 (colored)
In fragment identifiers, use ~%d for ordinal suffixes, and reserve the character '~' for that purpose. Bug found by validator.w3.org in openssl(1), which contains both a tag "tls1_2" and a second instance of a tag "tls1", which also resulted in "tls1_2", causing a clash. Now, the second instance of "tls1" is rendered as "tls1~2" instead, employing the newly reserved '~'.
Revision 1.3 / (download) - annotate - [select for diffs], Thu Apr 2 15:04:39 2020 UTC (5 years, 3 months ago) by schwarze
Branch: MAIN
Changes since 1.2: +4 -0 lines
Diff to previous 1.2 (colored)
Copy tagged strings before marking hyphens as breakable. For example, this makes ":tCo-processes" work in ksh(1).
Revision 1.2 / (download) - annotate - [selected], Wed Apr 1 20:21:20 2020 UTC (5 years, 3 months ago) by schwarze
Branch: MAIN
Changes since 1.1: +14 -0 lines
Diff to previous 1.1 (colored)
Just like we are already doing it in HTML output, automatically tag section and subsection headers in terminal output, too. Even though admittedly, commands like "/SEE" and "/ Subsec" work, too, there is no downside, and besides, with the recent improvements in the tagging framework, implementation cost is negligible.
Revision 1.1 / (download) - annotate - [select for diffs], Thu Feb 27 21:43:46 2020 UTC (5 years, 4 months ago) by schwarze
Branch: MAIN
Diff to selected 1.2 (colored)
Fully support explicit tagging of .Sh and .Ss. This fixes the offset of two lines in terminal output and this improves HTML output by putting the id= attribute and <a> element into the respective <h1> or <h2> element rather than writing an additional <mark> element. To that end, introduce node flags NODE_ID (to make the node a link target, for example by writing an HTML id= attribute or by calling tag_put()) and NODE_HREF (to make the node a link source, used only in HTML output, used only to write an <a class="permalink"> element). In particular: * In the validator, generalize the concept of the "next node" such that it also works before .Sh and .Ss. * If the first argument of .Tg is empty, don't forget to complain if there are additional arguments, which will be ignored. * In the terminal formatter, support writing of explicit tags for all kinds of nodes, not just for .Tg. * In deroff(), allow nodes to have an explicit string representation even when they aren't text nodes. Use this for explicitly tagged section headers. Suprisingly, this is sufficient to make HTML output work, without explicit code changes in the HTML formatter. * In syntax tree output, display NODE_ID and NODE_HREF.