summaryrefslogtreecommitdiff
path: root/tmac
Commit message (Collapse)AuthorAgeFilesLines
* [ms]: Fix content nits in documentation.G. Branden Robinson2023-05-141-2/+9
| | | | | * Explicitly tell the reader how to end section heading text. * Describe the handling of display distance in more detail.
* [man pages]: Adjust dead-tree pagination.G. Branden Robinson2023-05-051-0/+4
| | | | Also drop an unnecessary paragraph break in glilypond(1).
* [ms]: Align documentation.G. Branden Robinson2023-05-041-7/+10
| | | | Also slightly recast in places for better style.
* groff_man*(7): Tighten wording.G. Branden Robinson2023-04-211-3/+2
|
* groff_man*(7): Revise history.G. Branden Robinson2023-04-211-13/+13
| | | | | The changes I attributed to DWB 1.0 occurred earlier, in Unix System III.
* groff_man_style(7): Fix content nits.G. Branden Robinson2023-04-211-4/+7
| | | | | | | | * The no-break control character influences the interpretation of control lines, not requests per se. * Replace examples of typesetting output devices with their names in groff (i.e., as arguments to '-T')--not the names of the file formats these output devices generate.
* groff_ms(7): Use correct font macro.G. Branden Robinson2023-04-091-1/+1
| | | | Use font alternation, not simple font selection.
* [docs]: Update discussion of ms page titles.G. Branden Robinson2023-04-091-7/+11
| | | | | * Mention the special behavior of the % character in titles. * Characterize traps as a formatter feature.
* groff_mdoc(7): Fix style and markup nits.G. Branden Robinson2023-04-091-4/+4
| | | | | | | * Drop redundant use of `No` macro immediately after `Ns`. * Drop second argument to `Xr` where it is needlessly specific. * Clarify: Replace "flush left" with "indentation of zero". * Tweak grammar.
* groff_mdoc(7): Improve wording.G. Branden Robinson2023-04-091-1/+1
| | | | | Since "call" is an important term of art in mdoc composition, use a different word for its mundane meaning of appellation.
* tmac/an.tmac: Drop stale comment.G. Branden Robinson2023-04-011-1/+1
|
* groff_mdoc(7): Fix doubled word.G. Branden Robinson2023-04-011-1/+1
|
* groff_man_style(7): Clarify behavior of `\%`.G. Branden Robinson2023-04-011-7/+9
| | | | | | | Also clarify effects of `SY` and `YS` macros on adjustment. Prompted by Alex Colomar in <https://lists.gnu.org/archive/html/groff/2023-03/msg00079.html>.
* [tests]: Have more tests report output.G. Branden Robinson2023-02-222-0/+2
| | | | | | | | | | * src/roff/groff/tests/ab_works.sh: * src/roff/groff/tests/handle_special_input_code_points.sh: * src/roff/groff/tests/initialization_is_quiet.sh: * src/roff/groff/tests/msoquiet_works.sh: * src/roff/groff/tests/soquiet_works.sh: * tmac/tests/an-ext_MR-works.sh: * tmac/tests/an_MR-works.sh: Do it.
* [tests]: Avoid failures when $GROFF_ENCODING set.G. Branden Robinson2023-02-223-0/+9
| | | | | | | | | | | | | | | * src/roff/groff/tests/ab_works.sh: * src/roff/groff/tests/handle_special_input_code_points.sh: * src/roff/groff/tests/initialization_is_quiet.sh: * src/roff/groff/tests/msoquiet_works.sh: * src/roff/groff/tests/soquiet_works.sh: * tmac/tests/an-ext_MR-works.sh: * tmac/tests/an_MR-works.sh: * tmac/tests/an_font-remapping-does-not-affect-titles.sh: Unset $GROFF_ENCODING before running test because preconv(1) confounds these tests. Thanks to Alexis for reporting this problem.
* groff_man*(7): Clarify `RS` behavior.G. Branden Robinson2023-02-222-3/+8
| | | | | | Thanks to Alex Colomar for the feedback. Also align a code comment with the documentation.
* [ms]: Rename test.G. Branden Robinson2023-02-222-1/+1
| | | | | | | | | | | | | | * tmac/tests/s_no-excess-space-around-displays.tmac: Rename... * tmac/tests/s_no-excess-space-around-displays.sh: ...to this. * tmac/tmac.am (tmac_TESTS): Update. The original name of this test was a thoughtless error; renaming it more intelligibly facilitates a necessary procedure for getting the tests to run on Solaris 10 (where /bin/sh is a pre-POSIX clay tablet version). gsed -i -e '1s@#!/bin/sh@#!/usr/xpg4/bin/sh@' \ `find . -name '*.sh' | grep /tests/` PATH=/usr/xpg4/bin:$PATH gmake check
* [man pages]: Define page-local `MR` fallback.G. Branden Robinson2023-02-225-0/+75
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | [man pages]: Provide page-local fallback definition of new `MR` macro. I didn't think I was going to have to do this, but the premier site on the web for viewing Linux man pages, Michael Kerrisk's man7.org, has been pulling snapshots of the pages themselves without upgrading the underlying macros, and so man page cross references set with `MR` are getting lost in its presentations. (I acknowledge: Ingo Schwarze warned me something like this could happen.) This definition is intended as a stopgap measure only. I want to revert this after groff 1.23 is released and has spread to some reasonable degree. * contrib/chem/chem.1.man: * contrib/eqn2graph/eqn2graph.1.man: * contrib/gdiffmk/gdiffmk.1.man: * contrib/glilypond/glilypond.1.man: * contrib/gperl/gperl.1.man: * contrib/gpinyin/gpinyin.1.man: * contrib/grap2graph/grap2graph.1.man: * contrib/hdtbl/groff_hdtbl.7.man: * contrib/mm/groff_mm.7.man: * contrib/mm/groff_mmse.7.man: * contrib/mm/mmroff.1.man: * contrib/mom/groff_mom.7.man: * contrib/pdfmark/pdfroff.1.man: * contrib/pic2graph/pic2graph.1.man: * contrib/rfc1345/groff_rfc1345.7.man: * man/groff.7.man: * man/groff_char.7.man: * man/groff_diff.7.man: * man/groff_font.5.man: * man/groff_out.5.man: * man/groff_tmac.5.man: * man/roff.7.man: * src/devices/grodvi/grodvi.1.man: * src/devices/grohtml/grohtml.1.man: * src/devices/grolbp/grolbp.1.man: * src/devices/grolj4/grolj4.1.man: * src/devices/gropdf/gropdf.1.man: * src/devices/gropdf/pdfmom.1.man: * src/devices/grops/grops.1.man: * src/devices/grotty/grotty.1.man: * src/devices/xditview/gxditview.1.man: * src/preproc/eqn/eqn.1.man: * src/preproc/eqn/neqn.1.man: * src/preproc/grn/grn.1.man: * src/preproc/pic/pic.1.man: * src/preproc/preconv/preconv.1.man: * src/preproc/refer/refer.1.man: * src/preproc/soelim/soelim.1.man: * src/preproc/tbl/tbl.1.man: * src/roff/groff/groff.1.man: * src/roff/nroff/nroff.1.man: * src/roff/troff/troff.1.man: * src/utils/addftinfo/addftinfo.1.man: * src/utils/afmtodit/afmtodit.1.man: * src/utils/grog/grog.1.man: * src/utils/hpftodit/hpftodit.1.man: * src/utils/indxbib/indxbib.1.man: * src/utils/lkbib/lkbib.1.man: * src/utils/lookbib/lookbib.1.man: * src/utils/pfbtops/pfbtops.1.man: * src/utils/tfmtodit/tfmtodit.1.man: * src/utils/xtotroff/xtotroff.1.man: * tmac/groff_man.7.man.in: * tmac/groff_me.7.man: * tmac/groff_ms.7.man: * tmac/groff_trace.7.man: * tmac/groff_www.7.man: Do it. Fixes <https://savannah.gnu.org/bugs/?63825>. Thanks greatly to Alexis for identifying an issue with mandoc(1)'s handling of an earlier iteration of this fallback, and to John Gardner for identifying a method of detecting mandoc as the renderer at formatting time. Tested with groff 1.22.4, mandoc 1.14.5, and groff Git HEAD (of course). The sed script I used follows. /^\.cp 0/a\ .\ .\\" Define fallback for groff 1.23's MR macro if the system lacks it.\ .nr do-fallback 0\ .if !\\n(.f .nr do-fallback 1 \\" mandoc\ .if \\n(.g .if !d MR .nr do-fallback 1 \\" older groff\ .if !\\n(.g .nr do-fallback 1 \\" non-groff *roff\ .if \\n[do-fallback] \\{\\\ . de MR\ . ie \\\\n(.$=1 \\\ . I \\%\\\\$1\ . el \\\ . IR \\%\\\\$1 (\\\\$2)\\\\$3\ . .\ .\\}\ .rr do-fallback ANNOUNCE: Update bug counts. Credit Alexis with assistance.
* Revert "[man pages]: Define page-local `MR` fallback."G. Branden Robinson2023-02-215-65/+0
| | | | | | | | | | | This reverts commit 18d708e489758636ff9e168eee2592591755eb61. Unfortunately my clever hack [sic] does not work with mandoc 1.14.5, causing that tool to truncate the entire text of the man page after the summary description. The good news is that there is a simpler replacement that works better, forthcoming.
* [man]: Improve portability of a test.1.23.0.rc3G. Branden Robinson2023-02-201-2/+2
| | | | | | | | | * tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh: Improve portability of script by using shell constructs instead of the nonstandard GNU coreutils 'seq' utility. Resolves test failure on Solaris 10. * HACKING: Document this problem.
* tmac/tests/latin2_works.sh: Fix missing backslash.G. Branden Robinson2023-02-191-1/+1
| | | | | | * tmac/tests/latin2_works.sh: Fix missing backslash in printf. Solaris printf(1) was sensitive to this error; macOS and GNU printf were not. Fixes a test failure on Solaris 11.
* [man]: Tweak fix to Savannah #63768.G. Branden Robinson2023-02-182-9/+8
| | | | | | | | | | | | * tmac/an.tmac (MR): Ensure `an*url` always has a value, defaulting to "format 1" (man:page(section)). Resequence the macOS URL formats to sort the contemporary one before the others. * tmac/man.local: Reflect resequencing of integer assignments to formats. Clarify historicity of annotations. Continues <https://savannah.gnu.org/bugs/?63768>. Thanks to John Gardner for further discussion.
* [ms]: Port a test to Solaris 11 sed.G. Branden Robinson2023-02-171-1/+5
| | | | | | | | * tmac/tests/s_TC-works-with-percent-in-custom-titles.sh: Put newlines after opening braces in sed scripts. macOS and GNU sed tolerate their absence, but this sed does not. * HACKING: Document this problem.
* tmac/tests/an_use-input-traps-correctly.sh: Fix.G. Branden Robinson2023-02-151-2/+2
| | | | | | | * tmac/tests/an_use-input-traps-correctly.sh: Explicitly test `SM` and `SB` with 'ps' output device. If one set GROFF_TYPESETTER=utf8 in the test environment, these test cases would fail. Thanks to John Gardner for the report.
* groff_man*(7): Distinguish `RS`'s inset amount.G. Branden Robinson2023-02-151-5/+7
| | | | | | | | | ...from indentation. While both are horizontal distances, we are otherwise at pains to distinguish indentation from insets (left margin manipulation), and using "indentation" to name `RS`'s argument confounds this distinction. Prompted by discussion with Alex Colomar.
* groff_man*(7): Make clarifications.G. Branden Robinson2023-02-141-37/+51
| | | | | | | | | | | | | | | | | | | | * Stop discussing indentation of control lines. man(7) authors have no need of it. * Clarify that the leading dot is not part of a man(7) macro's name. * Weaken overgeneralization; all man(7) macros using traditional input traps don't respect output line continuation (`\c`), but `TP` does. * Update cross references to groff(7) "Measurements" section. * Back off the term "standardized" regarding man(7) section headings. * Suggest intro(1) as another place to discover a systems's expected manual section (suffixes). * Internally cross reference "Portability" subsection when raising \(ti escape sequence. * Use active voice when discussing handling of \: in hyperlinks. * Stop using "sections" in a loose manner when the word already has two other distinct meanings in this document. * Fix missing opening parenthesis. * Output devices don't "replace" characters; they format them. * Tighten wording.
* ANNOUNCE: Fix thinko.G. Branden Robinson2023-02-131-3/+3
| | | | tmac/an.tmac: Fix an incoherent explanation of division in a comment.
* [tmac]: Work around macOS od (mis-)behavior.G. Branden Robinson2023-02-133-20/+22
| | | | | | | | | | | | | | | | * tmac/tests/latin2_works.sh: * tmac/tests/latin5_works.sh: * tmac/tests/latin9_works.sh: Port to work around macOS's apparently POSIX non-conforming 'od' command. Use single-byte octal output format instead of "character", and update test expectations accordingly. Apparently gratuitously, macOS also puts more spaces after the octal address field when using this output format. * HACKING: Document, and elaborate upon, this problem. Also distinguish identical test failure diagnostics. ANNOUNCE: Remove caveat about automated test failures on macOS.
* [mdoc]: Port a test to work with macOS sed.G. Branden Robinson2023-02-131-1/+6
| | | | | | | | | | | * tmac/tests/doc_heading-font-remapping-works.sh: Put semicolons between commands and closing braces in sed script. Put each of multiple closing braces on a separate input line, because macOS doesn't accept them otherwise. Resolves test failure observed on macOS. * HACKING: Document the closing brace sequence problem. * ANNOUNCE: Drop notice of failing test case, now resolved.
* [man]: Port a test to work with macOS sed.G. Branden Robinson2023-02-131-2/+9
| | | | | | | | | | | * tmac/tests/an_TS-adds-no-vertical-space.sh: Put semicolons between commands and closing braces in sed script. Separate command stream into multiple '-e' expressions, breaking them after branch and label commands. Resolves test failure observed on macOS. * HACKING: Document the above problems. * ANNOUNCE: Drop notice of failing test case, now resolved.
* [docs]: Fix Savannah #68216.G. Branden Robinson2023-02-122-13/+14
| | | | | | | | | | | | | | | | | | | | | | | [docs]: Re-re-christen 'ESCAPE_AMPERSAND' ('\&'). Now call it a (non-transparent) "dummy character". Also rechristen 'ESCAPE_RIGHT_PARENTHESIS', ('\)') as the "transparent dummy character"; it has no impact on sentence-ending detection. * doc/groff.texi: * doc/meref.me.in: * man/groff.7.man: * man/groff_diff.7.man: * man/roff.7.man: * src/preproc/refer/refer.1.man: * tmac/groff_man.7.man.in: Do it. Fixes <https://savannah.gnu.org/bugs/?62816>. Thanks to Dave Kemper for the report and to the groff mailing list for the vigorous discussion. I don't expect my solution to please everyone. Also update references to the \& escape sequence in comments. ANNOUNCE: Update bug counts.
* groff_man*(7): Clarify authorship of extensions.G. Branden Robinson2023-02-121-2/+4
|
* [man]: Make multiple URL formats available.G. Branden Robinson2023-02-112-3/+26
| | | | | | | | | | | | | | | | | | | | * tmac/an.tmac: Add internal register `an*MR-URL-format` to select from a few known formats of man page hyperlink. There are three known on macOS, and one used everywhere else. * tmac/man.local: Document this feature so macOS users can enjoy the OSC 8 hyperlink feature if their terminal application supports it. I hope that this feature will be a temporary measure while macOS implements support for the man page URL format used everywhere else in the world. Fixes <https://savannah.gnu.org/bugs/?63768>. Thanks to John Gardner for the report, research, consultation, and testing. ANNOUNCE: Update bug counts. Also wrap previous ChangeLog entry at 72 columns.
* tmac/{man,mdoc}.local: Add "CW" font advice.G. Branden Robinson2023-02-092-0/+12
| | | | | | | Add commented-out technique for coping with this unportable font name. Prompted by Bjarni Ingi Gislason in <https://savannah.gnu.org/bugs/?63768>.
* tmac/{man,mdoc}.local: Update editor aid comments.G. Branden Robinson2023-02-092-6/+16
| | | | ...droppping old style Emacs file-local variable setting.
* Fix Savannah #63589.G. Branden Robinson2023-02-054-8/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Correct numerous typos and solecisms throughout the source tree. * ChangeLog: * ChangeLog.115: * ChangeLog.116: * ChangeLog.117: * ChangeLog.118: * ChangeLog.119: * ChangeLog.121: * ChangeLog.122: * Makefile.am: * NEWS: * PROBLEMS: * README: * contrib/chem/chem.am: * contrib/chem/chem.pl: * contrib/glilypond/README.txt: * contrib/glilypond/glilypond.pl: * contrib/hdtbl/groff_hdtbl.7.man: * contrib/mm/ChangeLog: * contrib/mm/m.tmac: * contrib/pdfmark/pdfmark.ms: * doc/automake.mom: * doc/groff.texi: * doc/me-revisions: * doc/webpage.ms: * m4/lib-link.m4: * man/groff.7.man: * man/groff_diff.7.man: * man/roff.7.man: * src/devices/grohtml/post-html.cpp: * src/devices/grolbp/lbp.h: * src/devices/gropdf/TODO: * src/devices/gropdf/gropdf.1.man: * src/devices/gropdf/gropdf.pl: * src/devices/xditview/ChangeLog: * src/devices/xditview/xditview.c: * src/libs/libdriver/input.cpp: * src/libs/libgroff/glyphuni.cpp: * src/preproc/eqn/eqn.1.man: * src/preproc/grn/gprint.h: * src/preproc/grn/main.cpp: * src/preproc/html/pre-html.cpp: * src/preproc/preconv/preconv.cpp: * src/preproc/tbl/table.cpp: * src/roff/groff/pipeline.c: * src/roff/groff/tests/substring_works.sh: * src/roff/groff/tests/use_point_size_escape_with_single_digit_arg.sh: * src/roff/troff/div.cpp: * src/roff/troff/input.cpp: * src/roff/troff/troff.1.man: * src/utils/grog/grog.pl: * src/utils/indxbib/indxbib.cpp: * src/utils/tfmtodit/tfmtodit.1.man: * tmac/doc-old.tmac: * tmac/doc.tmac: * tmac/groff_man.7.man.in: * tmac/hyphen.fr: Do it. Fixes <https://savannah.gnu.org/bugs/?63589>. Thanks to Bjarni Ingi Gislason for the report. * ANNOUNCE: Update bug counts. I also killed some pointless white space, refilled affected lines at 72 columns where convenient and non-disruptive to existing text flow, and corrected a misspelling of Ralph Corderoy's surname.
* groff_mdoc(7): Save & restore compatibility mode.G. Branden Robinson2023-02-031-1/+12
|
* [man pages]: Define page-local `MR` fallback.G. Branden Robinson2023-02-035-0/+65
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | [man pages]: Provide page-local fallback definition of new `MR` macro. I didn't think I was going to have to do this, but the premier site on the web for viewing Linux man pages, Michael Kerrisk's man7.org, has been pulling snapshots of the pages themselves without upgrading the underlying macros, and so man page cross references set with `MR` are getting lost in its presentations. (I acknowledge: Ingo Schwarze warned me something like this could happen.) This definition is intended as a stopgap measure only. I want to revert this after groff 1.23 is released and has spread to some reasonable degree. * contrib/chem/chem.1.man: * contrib/eqn2graph/eqn2graph.1.man: * contrib/gdiffmk/gdiffmk.1.man: * contrib/glilypond/glilypond.1.man: * contrib/gperl/gperl.1.man: * contrib/gpinyin/gpinyin.1.man: * contrib/grap2graph/grap2graph.1.man: * contrib/hdtbl/groff_hdtbl.7.man: * contrib/mm/groff_mm.7.man: * contrib/mm/groff_mmse.7.man: * contrib/mm/mmroff.1.man: * contrib/mom/groff_mom.7.man: * contrib/pdfmark/pdfroff.1.man: * contrib/pic2graph/pic2graph.1.man: * contrib/rfc1345/groff_rfc1345.7.man: * man/groff.7.man: * man/groff_char.7.man: * man/groff_diff.7.man: * man/groff_font.5.man: * man/groff_out.5.man: * man/groff_tmac.5.man: * man/roff.7.man: * src/devices/grodvi/grodvi.1.man: * src/devices/grohtml/grohtml.1.man: * src/devices/grolbp/grolbp.1.man: * src/devices/grolj4/grolj4.1.man: * src/devices/gropdf/gropdf.1.man: * src/devices/gropdf/pdfmom.1.man: * src/devices/grops/grops.1.man: * src/devices/grotty/grotty.1.man: * src/devices/xditview/gxditview.1.man: * src/preproc/eqn/eqn.1.man: * src/preproc/eqn/neqn.1.man: * src/preproc/grn/grn.1.man: * src/preproc/pic/pic.1.man: * src/preproc/preconv/preconv.1.man: * src/preproc/refer/refer.1.man: * src/preproc/soelim/soelim.1.man: * src/preproc/tbl/tbl.1.man: * src/roff/groff/groff.1.man: * src/roff/nroff/nroff.1.man: * src/roff/troff/troff.1.man: * src/utils/addftinfo/addftinfo.1.man: * src/utils/afmtodit/afmtodit.1.man: * src/utils/grog/grog.1.man: * src/utils/hpftodit/hpftodit.1.man: * src/utils/indxbib/indxbib.1.man: * src/utils/lkbib/lkbib.1.man: * src/utils/lookbib/lookbib.1.man: * src/utils/pfbtops/pfbtops.1.man: * src/utils/tfmtodit/tfmtodit.1.man: * src/utils/xtotroff/xtotroff.1.man: * tmac/groff_man.7.man.in: * tmac/groff_me.7.man: * tmac/groff_ms.7.man: * tmac/groff_trace.7.man: * tmac/groff_www.7.man: Do it. The sed script I used follows. I patched neqn(1), which does not require compatibility mode, by hand. /^\.cp 0/a\ .\ .\\" Define fallback for groff 1.23's MR macro if the system lacks it.\ .de @@\ . de MR\ . ie \\n(.$=1 \\\ . I \%\\$1\ . el \\\ . IR \%\\$1 (\\$2)\\$3\ . \\\\.\ ..\ .if \\n(.g .if !d MR .@@\ .if !\\n(.g .@@\ .rm @@
* [ms]: Enable no-space mode in `TE` macro.G. Branden Robinson2023-01-291-1/+4
| | | | | | * tmac/s.tmac (TE): Enable no-space mode after outputting the display distance vertically, replacing any inter-paragraph distance that might follow.
* [ms]: Tighten wording in docs.G. Branden Robinson2023-01-191-20/+16
|
* groff_ms(7): Relocate material.G. Branden Robinson2023-01-191-18/+18
| | | | | ...so that we can tighten some stuff and enforce sync with doc/ms.ms and doc/groff.texi.
* groff_man*(7): Fix content, style, markup nits.G. Branden Robinson2023-01-171-32/+51
| | | | | | | | | | | | | | | | | | | | Content: * Strengthen claims about correct `TH` usage. * Stop using the term "standardized" to describe something that isn't (formally). * Explicitly identify mandb(8)'s predecessor "makewhatis"; it's probably that tool that demands such cautious man(7) document preparation. Style: * Use active voice more. * Tighten wording. * Use modal auxiliary to indicate irrealis mood. (If an ellipsis makes something fit, it no longer overruns.) * Say "typesetting device" instead of "typesetter device", since few devices driven by groff are typesetters per se. Markup: * Apply more poor man's keeps to combat widows and orphans.
* groff_man_style(7): Refine "Fundamental concepts".G. Branden Robinson2023-01-171-57/+71
| | | | | | | | | | | | | | | | | | * Shift some material here from "Macro reference preliminaries". * Present, but do not define, "words". Describe how they are separated. (That's about as much definition as a man(7) package user needs.) * Link breaking and hyphenation more strongly. * Refer to command-line options as "options", not "flags". * Drop internal cross reference that duplicates one in the previous sentence. * Distinguish inter-sentence space from adjustment more strongly. * Define "control line". * Stop quoting double quotes; doing so looks crazy when degraded to basic Latin. (I can hear the reader now: "...so I double the double quotes?!") They're already parenthesized. * Define "argument". * Define "empty request". * Define "text line".
* groff_mdoc(7): Clarify comment.G. Branden Robinson2023-01-171-4/+4
|
* [man]: Stop SY/YS from re-enabling hyphenation.G. Branden Robinson2023-01-081-5/+12
| | | | | | | | | | | | | | | | | | | | * tmac/an-ext.tmac: Move the saving of the hyphenation mode from the "top level" to... (mY): ...this new macro. (SY, mQ, MR): Call `mY` before disabling hyphenation. Problem introduced by me in commit 096c2f0567, 16 February. "an-ext.tmac" gets sourced by "an.tmac" before any command-line setting of the `HY` register is handled, so (for groff) the stored hyphenation mode was the default for the language, not reflecting user disablement. The synopsis macros, which do not have an alternate implementation in "an.tmac" for leverage of groff features, were causing hyphenation to be resurrected (after `YS`) even if the user had disabled it. Saving the hyphenation mode anew upon entry to these macros is arguably inefficient, but it is more correct since a man page could conceivably manipulate the automatic hyphenation mode (even if that's not recommended outside of tbl(1) text blocks).
* [man]: Add regression test for hyphenation.G. Branden Robinson2023-01-082-0/+79
| | | | | | | | | | Add regression test for hyphenation getting wrongly restored by `YS`, `ME`, `UE`, and `MR` macros. * tmac/tests/an_HY-register-works.sh: Do it. * tmac/tmac.am (tmac_TESTS): Run test. Test fails at this commit.
* [mdoc]: Narrow scope of font remappings.G. Branden Robinson2023-01-061-10/+10
| | | | | | | | | * tmac/mdoc/doc-common (Sh, Ss): Narrow scope of font remappings lexically and restrict remapping to the heading font family (if any) to avoid undesired remapping of fonts in page headers if, say, a (sub)section heading begins just prior to a page break--which is ugly anyway and should be avoided, but the package has no keep macros and solving that problem in an automatic way promises to be complex.
* groff_man*(7): Fix style nits.G. Branden Robinson2023-01-061-11/+9
| | | | | | | | | | * Drop now-redundant wording about `TQ` causing a break. * Adjust dead-tree pagination. * Recast description of `MT`/`ME` and `UR`/`UE` macros for clarity; they bracket link text, not the hyperlink destinations. * Drop now-redunant wording about `SH`, `SS`, `TP`, and `HP` causing breaks. * Tighten wording.
* [man]: Style-warn if MT, UR not given arguments.G. Branden Robinson2023-01-031-0/+4
| | | | | * tmac/an.tmac (MT, UR): Throw style warning if macro called without (exactly one) argument.
* tmac/an.tmac: Fix code style nit.G. Branden Robinson2023-01-031-2/+4
| | | | Wrap long input lines.
View Lorry Controller Status