summaryrefslogtreecommitdiff
path: root/man/groff_diff.7.man
Commit message (Collapse)AuthorAgeFilesLines
* groff_diff(7): Fix missing punctuation.G. Branden Robinson2023-05-171-1/+1
|
* [docs]: Update discussion of `ss` request.G. Branden Robinson2023-05-131-2/+11
| | | | | | | | * doc/groff.texi (Manipulating Filling and Adjustment): Recast. Tighten wording. Document conventional space width. Fully discuss inter-sentence spacing behavior before documenting registers. * man/groff_diff.7 (Extended requests): Sync with the foregoing. * man/groff.7 (Read-only registers): Use less cramped English.
* [docs]: Reduce use of term "entity".G. Branden Robinson2023-04-241-33/+40
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Doug McIlroy noted this vague term, which groff employs for multiple purposes. Eliminate its application to input processing. There is now no longer such a thing as an "entity" in the groff language. * doc/groff.texi (Character Translations): Do it. Also clarify "nothing" as "the dummy character". (Using Symbols): Do it. Also recast explanation of difference between characters and glyphs. Explicitly state that spaces aren't glyphs. Document that `rchar` request can't remove definitions supplied by font description files. (Ligatures and Kerning): Speak of "special characters", not "entities". (Other Differences): Recast discussion of character-to-glyph transformation. Stop qualifying characters as "input". Recast discussion of example. * font/devutf8/NOTES: Revise use of terminology. Perform a Kemper notectomy. Wrap long lines. * man/groff.7.man (Request short reference) <char>: Speak of a "special character", not an "entity". <rchar>: Document that request can't remove definitions supplied by font description files. * man/groff_diff.7.man (Implementation differences): Sync with our Texinfo manual. The use of "entity" to describe how a glyph gets mapped back to a character (sequence) for the HTML and terminal output devices is retained. That usage is restricted to discussion of output drivers (code comments and function names notwithstanding).
* [docs]: Clarify interactions with aliased names.G. Branden Robinson2023-04-091-0/+13
|
* [man pages]: Define page-local `MR` fallback.G. Branden Robinson2023-02-221-0/+15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | [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-211-13/+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.
* [docs]: Fix Savannah #68216.G. Branden Robinson2023-02-121-7/+21
| | | | | | | | | | | | | | | | | | | | | | | [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.
* Fix Savannah #63589.G. Branden Robinson2023-02-051-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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.
* [man pages]: Define page-local `MR` fallback.G. Branden Robinson2023-02-031-0/+13
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | [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 @@
* [docs]: Clarify discussion of "scaled points".G. Branden Robinson2022-12-281-9/+8
| | | | | | | | | | | | | | * doc/groff.texi (Changing the Type Size): Replace duplicated material with cross reference to section/node "Using Fractional Type Sizes". (Using Fractional Tyep Sizes): Recast. Clarify how "scaled points" get scaled. Push presentation of "z" scaling unit out of the way of this narrative. (DESC File Format): Improve definition of "sizescale" directive. * man/groff_diff.7.man: * man/groff_font.5.man: Sync with the foregoing.
* [docs]: Tighten `string{down,up}` description.G. Branden Robinson2022-12-181-4/+6
|
* [docs]: Fix content and style nits.G. Branden Robinson2022-10-231-4/+4
| | | | | * Fix thinko: `ps` request, not `size` request! * Tighten or recast wording.
* [docs]: Fix scaled points material content nits.G. Branden Robinson2022-10-211-3/+4
| | | | | | | | | | * Point out that bracketed and delimited forms of \s accept explicit scaling units. Also: * Tighten wording. * (groff.texi) Bump document revision date. * (groff_diff.7.man) Quote multi-word subsection title.
* Document a CSTR #54 erratum re: \n(st and \n(sb.G. Branden Robinson2022-10-211-5/+21
| | | | | | | | * doc/groff.texi (Page Motions): * man/groff.7.man (Writable registers): * man/groff_diff.7.man (New registers): Do it. * PROBLEMS: Further clarify. Note DWB and Heirloom behavior.
* [docs]: Recast description of \Z escape sequence.G. Branden Robinson2022-10-111-1/+5
|
* groff_diff(7): Sync \B description w/ groff.texi.G. Branden Robinson2022-10-111-11/+8
|
* [docs]: Improve metasyntactic variable discipline.G. Branden Robinson2022-10-111-33/+33
| | | | | | | | | | | | | | Try to reduce confusion between strings (variables) and string contents. Say "contents" when we mean what we would call a string literal in C. This way, when we speak of "string interpolation", the reader knows we always mean something that has an identifier. Refer to to character identifiers as "c" rather than "g"; I find it more coherent to not regard something as a glyph until it hits intermediate output, at the earliest, which means we don't deal with with glyphs in the roff language per se. (What we do is describe them using characters, typefaces, sizes, slant, color, and so on, with sufficient precision that an output device can _produce_ a glyph.)
* [docs]: Align presentations of `\A`.G. Branden Robinson2022-10-111-14/+11
|
* [docs]: Fix grammar nit.G. Branden Robinson2022-10-111-1/+1
| | | | Use adverbial forms for adverbs.
* [docs]: Standardize on term "numeric".G. Branden Robinson2022-10-111-2/+2
| | | | | | | | "Numeric" and "numerical" are synonyms; prefer the shorter form. (I shall prepare for critiques on English usage from the U.K.; the spectacle should be ironical and barbarical, a fitting entertainment for the modern major generical.)
* [docs]: Standardize phraseology.G. Branden Robinson2022-10-111-10/+7
| | | | ...when discussing requests that strip a leading " from their argument.
* [docs]: Revise material on fractional type sizes.G. Branden Robinson2022-10-091-26/+83
| | | | | | | | | | | | | | | | | | * doc/groff.texi: * Motivate the feature. * Rename some nodes: - Sizes -> Manipulating Type Size and Vertical Spacing - Changing Type Sizes -> Changing the Type Size - Fractional Type Sizes -> Using Fractional Type Sizes * Change example of requested vs. realized type size to be more plausible. * Add new node, "Changing the Vertical Spacing". * Migrate terminology: - escape -> escape sequence - scaling indicator -> scaling unit * Recast for clarity and tightness. * man/groff_diff.7.man: Sync with the foregoing.
* groff_diff(7): Fix style nits.G. Branden Robinson2022-10-091-2/+5
| | | | | * Set terms in italics in summary-description (Savannah #63150). * Tighten wording.
* [docs]: Document plan9port troff support for `\~`.G. Branden Robinson2022-08-141-9/+8
| | | | | | | Update Plan 9 from User Space troff info thanks to Dan Cross's superfast merge of my pull request. https://github.com/9fans/plan9port/pull/567
* [docs]: Shift discussion of `\~` portability.G. Branden Robinson2022-08-141-0/+35
| | | | | | | | * doc/groff.texi (Request and Macro Arguments): Move from here... (Other Differences): ...to here. * man/groff_diff.7.man (Implementation differences): * tmac/groff_man.7.man.in (Portability): Sync with the above.
* doc/groff.texi: Fix content and style nits.G. Branden Robinson2022-08-051-6/+9
| | | | | | | | | | | - Revise leader/table of contents example. - Migrate terminology: "escape" -> "escape sequence". - Fix grammar nits (use plurals more consistently). - Move misplaced modifiers (the dread "only"). - Bump document date. * man/groff.7.man: * man/groff_diff.7.man: Sync.
* [docs]: Revise discussion of spaces and motions.G. Branden Robinson2022-06-151-2/+4
| | | | | | | | | | | | | | | | Draw a sharper distinction between "spaces", which are adjustable and discardable, and horizontal motions, which are not. * doc/groff.texi: Relocate presentation of `\~` escape sequence... (Page Motions): ...from here... (Manipulating Filling and Adjustment): ...to here, much earlier. (Page Motions): Recast descriptions of `\v`, `\h`, `\space`, `\|`, `\^`, `\0`. * man/groff.7.man: * man/groff_diff.7.man: * man/groff_font.5.man: Sync with updated descriptions above.
* [man pages]: Fix markup nit.G. Branden Robinson2022-06-151-3/+3
| | | | | | Add `\&` after a dot followed by multiple spaces in displayed examples, to keep the rendering consistent even if the reader changes the supplemental inter-sentence space amount.
* [man pages]: Fix style macro and \c usage with TP.G. Branden Robinson2022-06-081-7/+7
| | | | | | | | | | | | | | | | | | | | | The fix for Savannah #51468 means that use of single-font macros like `B` and `I` no longer works correctly when they appear terminated with a `\c` escape sequence in a `TP` paragraph tag. Recast to use two-font macros, which have no such difficulty. * contrib/chem/chem.1.man: * contrib/mm/groff_mm.7.man: * man/groff_char.7.man: * man/groff_diff.7.man: * man/groff_tmac.5.man: * src/devices/grolj4/grolj4.1.man: * src/devices/gropdf/gropdf.1.man: * src/preproc/eqn/eqn.1.man: * src/preproc/pic/pic.1.man: Stop using single-font macros with `\c` in paragraph tags. Also: * man/groff_char.7.man: Make a wrongly bold closing bracket roman.
* [docs]: Update discussion of `itc` request.G. Branden Robinson2022-06-061-2/+2
| | | | | | | | | | | | | | | | | | | | | * Say "written (or drawn) output" instead of "formatted output", to avoid the question of whether horizontal and vertical motions constitute formatting operations. (Input traps ignore them.) * Update first `it` example to extend, use `\c`, and include output. * Regarding `itc`, say simply "lines", instead of "text lines", since control lines like ".if 1 foo" certainly produce written output. * Replace `itc` example with slight modification of first `it` example to illustrate how `\c` is handled differently. * Drop incorrect claim (introduced by me in commit ada4fb3266, 19 May) that `\h` and `\v` "count" for `it`/`itc` purposes; they don't. * Add demonstration of (non-)impact of `sp` request and horizontal motion escape sequence on `it` line count in spite of obvious effects on output. Also synchronize groff(7) and groff_diff(7) summaries of `itc` request. Prompted by <https://lists.gnu.org/archive/html/groff/2022-06/msg00026.html>.
* [docs]: Migrate terminology.G. Branden Robinson2022-06-061-3/+3
| | | | | ...from horizontal/vertical "resolution" to "motion quantum". Devices already have a "resolution", which applies to both axes.
* doc/groff.texi: Reorg Implementation Differences.G. Branden Robinson2022-05-311-2/+2
| | | | | | | | | * Organize discussion into "safer mode", "compatibility mode", and everything else. * Tighten wording in discussion of `.cp` register to buy a line in DVI/PDF version of our Texinfo manual. Also sync groff_diff(7) with foregoing wording change.
* [docs]: Update and sync device control stuff.G. Branden Robinson2022-05-211-8/+80
| | | | | | | | | | | | | | | | | | | | | | | * doc/groff.texi (Postprocessor Access): Flesh out introduction; motivate the feature better. Indicate where details can be found. Mark node as reviewed for correct glyph usage. Move cross reference to introductory paragraph. <device>: Document request's handling of leading double quote in argument. Convert erroneous uses of program index to concept index entries. Drop now-redundant sentence about handling of `\\` input sequence in device control escape or request arguments. <devicem>: Use `name` as metasyntactic variable name since it is the name of a macro, and matches the argument label in the adjacent `\Y[]` form. * man/groff.7.man (Request short reference) <device, devicem>: (Escape short reference) <\X, \Y>: * man/groff_diff.7.man (Escape sequences) <\X>: (New requests) <device, devicem>: Sync with information in our Texinfo manual. Also fix style nit: use semicolons to separate list items that already contain commas.
* [docs]: Update discussion of \[] escape sequence.G. Branden Robinson2022-05-211-5/+9
| | | | | | | * Identify the first argument, the base glyph, as distinct. * Fix error: there are four escape sequences with bespoke syntax forms that are effectively one-character special character names, not one. * Synchronize groff_diff(7) with our Texinfo manual in this area.
* [docs]: Revise discussion of \O escape sequences.G. Branden Robinson2022-05-151-59/+81
| | | | | | | | | | | * Recast for more consistent use of terminology. * Horizontal motions corresponding to glyphs are still honored, but those corresponding to rules are not. * Document the additional information emitted by \O2. Also adjust dead-tree typography. Also fix straggling use of "escape" where "escape sequence" is meant.
* [docs]: Migrate terminology.G. Branden Robinson2022-03-291-5/+5
| | | | | | | | ...from "warning of type" to "warning in category", to align with our presentation in troff(1) and our Texinfo manual's "Debugging" node. Also say simply "warning" instead of "warning diagnostic" in one instance.
* [docs]: (hyphenation codes) Tweak wording.G. Branden Robinson2022-03-291-3/+3
|
* [man pages]: Fix style nits.G. Branden Robinson2022-03-211-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * contrib/chem/chem.1.man: Spell out small numerals in prose. * contrib/chem/chem.1.man: * contrib/hdtbl/groff_hdtbl.7.man: Break input lines after commas. * contrib/groff_filenames/groff_filenames.5.man: Tighten wording. * contrib/groff_filenames/groff_filenames.5.man: Reduce use of italics and bold. * contrib/hdtbl/groff_hdtbl.7.man: Refer to fonts by their actual names rather than versions transformed for file system storage. * contrib/hdtbl/groff_hdtbl.7.man: Clarify reference to "main" macro packages. * contrib/hdtbl/groff_hdtbl.7.man: * man/groff_out.5.man: Set "groff" in italics. * contrib/hdtbl/groff_hdtbl.7.man: Tighten wording. * contrib/hdtbl/groff_hdtbl.7.man: Set an example within a sentence. * man/groff_diff.7.man: * man/roff.7.man: Set bulleted lists (`IP` paragraphs using \[bu] as a tag) with an indentation of only 2n. * man/groff_diff.7.man: Slightly recast discussion of "legacy" output command. (This really needs a rewrite given the clear motivation for the feature documented in CSTR #97.) * man/groff_out.5.man: Stop setting an ellipsis in italics. * src/preproc/eqn/eqn.1.man: Tighten discussion of "nroff" parameter. * src/preproc/grn/grn.1.man: Italicize "x" and "y" when used as coordinate axes. * tmac/groff_man.7.man.in: Drop hyphen when using "cross reference" as a noun.
* [docs]: Fix environment-related content nits.G. Branden Robinson2022-03-161-2/+1
| | | | | | | | | | | | doc/groff.texi (Environments): + Refer to "typeface", not "font", parameters: in groff, the "font" is a family combined with a style, or a standalone face; "typeface" is a more general concept and a better fit for what environments track. + Note the control character as part of the environment. doc/groff.texi (Environments) <evc>: man/groff_diff.7.man (New requests) <evc>: Fix semicolon splice.
* groff(7), groff_diff(7): Fix style nit.G. Branden Robinson2022-03-161-1/+2
| | | | Perform a Kemper notectomy.
* [docs]: Fix content nit.G. Branden Robinson2022-03-141-3/+5
| | | | | | Consistently refer to inter-sentence "space", not "spacing". Also prefix this term with "additional" anywhere the context might not make it clear (or where the context is highly general).
* [man pages]: Fix markup nit.G. Branden Robinson2022-03-061-10/+10
| | | | | | | | Drop leading hyphenation control escape sequence prefixed to interpolations of patterns replaced by sed(1) during man page source generation; the replacements already begin with '\%'. Continues 2290508cde, 21 February.
* groff_diff(7): Update discussion of `\f` and `\F`.G. Branden Robinson2022-03-021-10/+16
|
* [docs]: Fix style nits.G. Branden Robinson2022-02-211-6/+7
| | | | | | * Migrate terminology: "escape" -> "escape sequence". * Tighten wording. * Sync groff_diff(7) with our Texinfo manual.
* [man pages]: Improve color support documentation.G. Branden Robinson2022-02-211-51/+97
| | | | | | | * Call its existence out in a section (groff_diff(7)) and subsection (groff(7)). * groff_diff(7): Sync request and escape sequence documentation with our Texinfo manual.
* [docs]: Fix style nit.G. Branden Robinson2022-02-121-6/+6
| | | | | | | Migrate from "start-up" to "startup". As Dave Kemper noted in Savannah bug #62036, both are accepted usages. I prefer the latter because we do not say "shut-down" (whether in regard to groff, or in Unix parlance generally).
* [man pages]: Drop unnecessary use of \& escapes.G. Branden Robinson2022-02-011-3/+3
| | | | | | | | | | | Use of the non-printing input break \& _before_ a dot is a recommended practice to prevent the dot from becoming misinterprted as a control character when a text line is reflowed/refilled in a text editor. However, this reasoning does not apply to control lines, which generally cannot be reflowed without damaging the document. So get rid of 'em.
* doc/groff.texi: Expand on 'ie', 'el', 'while'.G. Branden Robinson2022-01-271-41/+61
| | | | | | | | | | | | | | | | | | | | * (if-else): Illustrate behavior of nested `ie`/`el` usage without conditional blocks (brace escapes), which surprises some people. * (while): Recast. Clarify. Improve organization. ("Some remarks." followed by a bulleted list is pretty lazy exposition.) Define the term "body" in context of a `while` request. Update likening to macro definition to point out a difference: a `while` body is not read in copy mode. Fix misleading statement suggesting that the limit to macro recursion is fixed. Also: * Add concept index entries for the distinction between characters and glyphs. * man/groff_diff.7.man (New requests) <break, continue, while>: Synchronize with the above.
* [man pages]: Fix typos.Bjarni Ingi Gislason2022-01-251-2/+2
| | | | Fixes <https://savannah.gnu.org/bugs/?61430>.
* [man pages]: Fix markup nits.G. Branden Robinson2022-01-211-1/+1
| | | | | * Use \[ha] special character for basic Latin circumflex accent. * Use \[ti] special character for basic Latin tilde.
View Lorry Controller Status