![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Up to [cvsweb.bsd.lv] / mandoc / regress / man / IP
Up to [cvsweb.bsd.lv] / mandoc / regress / man / IP
Request diff between arbitrary revisions
Default branch: MAIN
Current tag: MAIN
Revision 1.8 / (download) - annotate - [select for diffs], Wed Jul 6 14:35:00 2022 UTC (2 years, 2 months ago) by schwarze
Branch: MAIN
CVS Tags: HEAD
Changes since 1.7: +4 -4 lines
Diff to previous 1.7 (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.7 / (download) - annotate - [select for diffs], Fri Oct 16 17:22:46 2020 UTC (3 years, 11 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_6
Changes since 1.6: +14 -28 lines
Diff to previous 1.6 (colored)
In HTML output, avoid printing a newline right after <pre> and right before </pre> because that resulted in vertical whitespace not requested by the manual page author. Formatting bug reported by Aman Verma <amanraoverma plus vim at gmail dot com> on discuss@.
Revision 1.6 / (download) - annotate - [select for diffs], Mon Apr 20 13:07:25 2020 UTC (4 years, 5 months ago) by schwarze
Branch: MAIN
Changes since 1.5: +3 -3 lines
Diff to previous 1.5 (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.5 / (download) - annotate - [select for diffs], Fri Mar 13 15:32:32 2020 UTC (4 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.4: +4 -4 lines
Diff to previous 1.4 (colored)
Split tagging into a validation part including prioritization
in tag.{h,c} and {mdoc,man}_validate.c
and into a formatting part including command line argument checking
in term_tag.{h,c}, html.c, and {mdoc|man}_{term|html}.c.
Immediate functional benefits include:
* Improved prioritization of automatic tags for .Em and .Sy.
* Avoiding bogus automatic tags when .Em, .Fn, or .Sy are explicitly tagged.
* Explicit tagging of .Er and .Fl now works in HTML output.
* Automatic tagging of .IP and .TP now works in HTML output.
But mainly, this patch provides clean earth to build further improvements on.
Technical changes:
* Main program: Write a tag file for ASCII and UTF-8 output only.
* All formatters: There is no more need to delay writing the tags.
* mdoc(7)+man(7) formatters: No more need for elaborate syntax tree inspection.
* HTML formatter: If available, use the "string" attribute as the tag.
* HTML formatter: New function to write permalinks, to reduce code duplication.
Style cleanup in the vicinity while here:
* mdoc(7) terminal formatter: To set up bold font for children,
defer to termp_bold_pre() rather than calling term_fontpush() manually.
* mdoc(7) terminal formatter: Garbage collect some duplicate functions.
* mdoc(7) HTML formatter: Unify <code> handling, delete redundant functions.
* Where possible, use switch statements rather than if cascades.
* Get rid of some more Yoda notation.
The necessity for such changes was first discussed with kn@, but i didn't
bother him with a request to review the resulting -673/+782 line patch.
Revision 1.4 / (download) - annotate - [select for diffs], Tue Sep 3 18:19:41 2019 UTC (5 years ago) by schwarze
Branch: MAIN
Changes since 1.3: +2 -4 lines
Diff to previous 1.3 (colored)
adapt to new <p> output logic (html.c rev. 1.260)
Revision 1.3 / (download) - annotate - [select for diffs], Fri Mar 1 10:57:19 2019 UTC (5 years, 6 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_5
Changes since 1.2: +3 -0 lines
Diff to previous 1.2 (colored)
Wrap .Sh/.SH sections and .Ss/.SS subsections in HTML <section> elements as recommended for accessibility by the HTML 5 standard. Triggered by a similar, but slightly different suggestion from Laura Morales <lauretas at mail dot com>.
Revision 1.2 / (download) - annotate - [select for diffs], Fri Jan 11 12:56:44 2019 UTC (5 years, 8 months ago) by schwarze
Branch: MAIN
Changes since 1.1: +2 -2 lines
Diff to previous 1.1 (colored)
Remove the HTML title= attributes which harmed accessibility and violated the principle of separation of content and presentation. Instead, implement the tooltips purely in CSS. Thanks to John Gardner <gardnerjohng at gmail dot com> for suggesting most of the styling in the new ::before rules.
Revision 1.1 / (download) - annotate - [select for diffs], Sun Jan 6 04:55:11 2019 UTC (5 years, 8 months ago) by schwarze
Branch: MAIN
Finally, represent the man(7) .PP and .HP macros by the natural choice, which is the <p> HTML element. On top of the previous fill-mode improvements, the key to making this possible is to automatically close the <p> when required: before headers, subsequent paragraphs, lists, indented blocks, synopsis blocks, tbl(7) blocks, and before blocks using no-fill mode. In man(7) documents, represent the .sp request by a blank line in no-fill mode and in the same way as .PP in fill mode.