CVS log for mandoc/regress/mdoc/Fl/Makefile

[BACK] Up to [cvsweb.bsd.lv] / mandoc / regress / mdoc / Fl

Request diff between arbitrary revisions


Default branch: MAIN
Current tag: MAIN


Revision 1.8 / (download) - annotate - [select for diffs], Sun Apr 26 21:41:08 2020 UTC (4 years, 5 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_6, HEAD
Changes since 1.7: +4 -4 lines
Diff to previous 1.7 (colored)

While we do not recommend the idiom ".Fl Fl long" for long options
because it is an abuse of semantic macros for device-specific
presentational effects, this idiom is so widespread that it makes
sense to convert it to the recommended ".Fl \-long" during the
validation phase.  For example, this improves HTML formatting
in pages where authors have used the dubious .Fl Fl.

Feature suggested by Steffen Nurpmeso <steffen at sdaoden dot eu>
on freebsd-hackers.

Revision 1.7 / (download) - annotate - [select for diffs], Fri Mar 13 15:32:42 2020 UTC (4 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.6: +5 -2 lines
Diff to previous 1.6 (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.6 / (download) - annotate - [select for diffs], Thu Feb 27 01:44:02 2020 UTC (4 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.5: +2 -2 lines
Diff to previous 1.5 (colored)

Introduce the concept of nodes that are semantically transparent:
they are skipped when looking for previous or following high-level
macros.  Examples include roff(7) .ft, .ll, and .ta, mdoc(7) .Sm
and .Tg, and man(7) .DT and .PD.  Use this concept for a variety
of improved decisions in various validators and formatters.

While here,
* remove a few const qualifiers on struct arguments that caused trouble;
* get rid of some more Yoda notation in the vicinity;
* and apply some other stylistic improvements in the vicinity.

I found this class of issues while considering .Tg patches from kn@.

Revision 1.5 / (download) - annotate - [select for diffs], Sat Jun 10 01:49:06 2017 UTC (7 years, 3 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_5, VERSION_1_14_4, VERSION_1_14_3, VERSION_1_14_2
Changes since 1.4: +1 -0 lines
Diff to previous 1.4 (colored)

style message about missing blank before trailing delimiter;
inspired by mdoclint(1), and jmc@ considers it useful

Revision 1.4 / (download) - annotate - [select for diffs], Wed Mar 8 22:54:50 2017 UTC (7 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.3: +0 -1 lines
Diff to previous 1.3 (colored)

Now that markdown output is tested for almost everything, test all
input files in -T markdown output mode by default and only mark
those files with SKIP_MARKDOWN that are not to be tested.
Much easier to read, and almost minus 40 lines of Makefile code.

Revision 1.3 / (download) - annotate - [select for diffs], Tue Mar 7 13:28:03 2017 UTC (7 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.2: +1 -1 lines
Diff to previous 1.2 (colored)

fix spacing after empty .Fl

Revision 1.2 / (download) - annotate - [select for diffs], Sun Mar 5 19:59:53 2017 UTC (7 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.1: +1 -0 lines
Diff to previous 1.1 (colored)

first batch of -T markdown tests

Revision 1.1 / (download) - annotate - [select for diffs], Wed Feb 8 03:02:53 2017 UTC (7 years, 7 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_1, VERSION_1_13

Finally port the OpenBSD regression suite.
Both kristaps@ and wiz@ repeated asked for this,
literally for years.

This form allows you to request diff's between any two revisions of a file. You may select a symbolic revision name using the selection box or you may type in a numeric name using the type-in text box.




CVSweb