summaryrefslogtreecommitdiff
Commit message (Collapse)AuthorAgeFilesLines
...
* [docs]: Reduce use of term "entity".G. Branden Robinson2023-04-244-99/+116
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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).
* doc/groff.texi: Use idiomatic Texinfo notation.G. Branden Robinson2023-04-241-21/+26
| | | | Use "@code{\@key{RET}}" and "@code{\@key{SP}}" consistently.
* doc/groff.texi: Drop old cautionary note.G. Branden Robinson2023-04-241-30/+0
| | | | | | | | | | | | | This material dates to commit 21260e1cd2, 7 June 2002. Anyone using .tr éÉ back then, or, since December 2005 when preconv(1) became available, using that, must have long since migrated. Also this passage is getting in the way of my terminological reforms. Entities begone!
* [docs]: Tweak escape/control character discussion.G. Branden Robinson2023-04-242-64/+67
| | | | | | | | | | * Introduce term "ordinary character", an input character that is not invalid (cf. "special character"). * Recast discussion of control, no-break control, and escape control characters in terms of ordinary characters, ruling out the surmise that a special character can serve as any of these. * Parallelize wording of these. * Tighten and align wording with this terminology.
* [docs]: Further clarify end-of-sentence detection.G. Branden Robinson2023-04-243-6/+17
| | | | | | | | | | | | | (One hopes.) * doc/groff.texi (Sentences): * man/roff.7 (Concepts): Do it. Fixes <https://savannah.gnu.org/bugs/?64091>. Thanks to Ingo Schwarze and Dave Kemper for the report. Also fix whitespace nit. Thanks to Dave Kemper, he of the unflinching osprey gaze.
* PROBLEMS: Update expected diagnostic text.G. Branden Robinson2023-04-241-6/+3
| | | | Thanks to Dave Kemper for catching this.
* doc/groff.texi: Fix content and style nits.G. Branden Robinson2023-04-211-36/+36
| | | | | | | | | | | | | | | * Qualify claim that text lines produce output--they don't (right away) if they're diverted. * Fix copy-and-paste goof in description of `rj` request. * Use Texinfo @key command to mark keyboard control character input. * Refer to enablement _status_ as a Boolean value. * Prefer "non-positive" over "nonpositive". * Use Texinfo @: command after prose colons, for consistency with the rest of this document. * Drop unnecessary commas. * Drop empty requests in an example where we desperately need the vees. * Use active voice more, and otherwise tighten wording to buy vees and improve page layout.
* doc/groff.texi: Clarify `ss` request, hyphenation.G. Branden Robinson2023-04-211-10/+13
|
* groff_man*(7): Tighten wording.G. Branden Robinson2023-04-211-3/+2
|
* [docs]: Fix content and style nits.G. Branden Robinson2023-04-212-17/+20
| | | | | | | | Discuss alignment, adjustment, and margins more carefully. Adjustment doesn't spread output lines to "both margins" if the indentation is nonzero. Describe the adjustment process explicitly. Add emphasis distinguishing `.ce` from `.ad c`. Drop terms "ragged-left" and "ragged-right" from running text (but keep their concept index entries).
* groff_mm(7): Drop garbage.G. Branden Robinson2023-04-211-2/+0
|
* 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.
* tbl(1): Fix style nits.G. Branden Robinson2023-04-201-22/+32
| | | | | | | | | | | | | | * Kick mention of region option case-invariance down to "GNU tbl enhancements" subsection. * Discuss the content of column descriptors _before_ discussing how they're separated. * Arrange mentions of column modifier correspondence to *roff requests consistently, _after_ covering the syntax of those modifiers. * Clarify that tbl doesn't perform measurements itself; it constructs formatter instructions to do so. * Tighten wording. Also adjust dead-tree pagination.
* PROBLEMS: Clarify Solaris/macOS portability items.G. Branden Robinson2023-04-201-21/+31
|
* PROBLEMS: Fix indentation in answer.G. Branden Robinson2023-04-161-6/+6
|
* PROBLEMS: Annotate a control character land mine.G. Branden Robinson2023-04-161-1/+3
|
* PROBLEMS: Update Hurd item and some shebangs.G. Branden Robinson2023-04-161-3/+3
| | | | | | | Per Bruno Haible, GNU/Hurd is passing all tests as of 1.23.0.rc4. Regarding shebangs, groff has unfortunately done its part in spreading a myth. See <https://savannah.gnu.org/bugs/?64058>.
* PROBLEMS: Update discussions.G. Branden Robinson2023-04-161-2/+8
| | | | | * Advise reader to not necessarily take "/usr/local" literally. * Admit that SunOS employed non-standard extensions to man(7) as well.
* PROBLEMS: Coalesce gdiffmk items.G. Branden Robinson2023-04-161-15/+20
| | | | Also borrow wording from "ANNOUNCE".
* PROBLEMS: Replace commit IDs with version numbers.G. Branden Robinson2023-04-161-33/+13
|
* PROBLEMS: Resequence file.G. Branden Robinson2023-04-161-502/+588
| | | | | | | Explain the order that it's in, to aid readers and, I hope, help maintainers keep it in order. Still to do: replace Git commit info with groff release info.
* ANNOUNCE: Clarify gdiffmk issues.G. Branden Robinson2023-04-161-1/+9
|
* groff(7): Fix missing word.G. Branden Robinson2023-04-161-1/+2
|
* ANNOUNCE: Revise.G. Branden Robinson2023-04-161-12/+10
|
* ANNOUNCE: Reflect Savannah #62695 fix.1.23.0.rc4G. Branden Robinson2023-04-141-3/+3
|
* [docs]: Minimally document `tag`, `taga` requests.G. Branden Robinson2023-04-143-0/+21
| | | | | | | | | | | | | | | | | | | * doc/groff.texi (Postprocessor Access): * man/groff.7 (Request short reference): Do it. Fixes <https://savannah.gnu.org/bugs/?62695>. I don't know if we need to keep these. They do much the same thing as `device`, and are implemented nearly identically to each other. They have only one user, the also undocumented "devtag.tmac". One difference is that the `device` request constructs a "macro" (internally to GNU troff), and `tag{,a}` construct strings (from groff's string class, not the C++ standard library's). Possibly the type used for storage of the node contents is intended to address some of the same problems we've seen crop up in issues like Savannah #63074.
* groff(7): Fix content and markup nits.G. Branden Robinson2023-04-141-1/+1
| | | | Use correct metasyntactic variable name. Use font alternation macro.
* eqn(1): Fix style and content nits.G. Branden Robinson2023-04-141-2/+2
| | | | | Align language with forthcoming (post-1.23.0) changes from Savannah ticket #63967.
* ANNOUNCE: Reflect Savannah #64032 fix.G. Branden Robinson2023-04-141-3/+3
|
* eqn(1): Revise discussion of font primitives.G. Branden Robinson2023-04-141-63/+52
| | | | Thanks to Doug McIlroy and Ralph Corderoy for the feedback.
* [docs]: Fix typo.G. Branden Robinson2023-04-143-2/+12
|
* Move ChangeLog entry to correct file.G. Branden Robinson2023-04-142-10/+10
|
* NEWS: Add item regarding spacing in ms(7).G. Branden Robinson2023-04-101-0/+7
|
* groff_ms(7): Use correct font macro.G. Branden Robinson2023-04-091-1/+1
| | | | Use font alternation, not simple font selection.
* eqn(1): Fix missing comma.G. Branden Robinson2023-04-091-1/+2
|
* eqn(1): Clarify new primitives.G. Branden Robinson2023-04-091-0/+10
| | | | The list below this subsection title isn't comprehensive.
* doc/ms.ms: Use `bp` requests better.G. Branden Robinson2023-04-091-8/+32
| | | | When forcing a page break to start a new section, break the line first.
* [docs]: Update discussion of ms page titles.G. Branden Robinson2023-04-093-17/+29
| | | | | * Mention the special behavior of the % character in titles. * Characterize traps as a formatter feature.
* groff_mm(7): Recast pg header/footer macro descs.G. Branden Robinson2023-04-091-55/+87
|
* groff_mm(7): Recast .TC, \*[Ci], and \n[Cl] descs.G. Branden Robinson2023-04-091-72/+106
| | | | | Also fix an orphaned line by adjusting dead-tree typography of `P` macro description.
* 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.
* doc/groff.texi: Fix misplaced punctuation.G. Branden Robinson2023-04-091-1/+1
|
* [docs]: Cross reference copy mode consistently.G. Branden Robinson2023-04-092-23/+30
| | | | ...but drop one cross reference that is already quite close to another.
* [docs]: Clarify interactions with aliased names.G. Branden Robinson2023-04-093-41/+86
|
* groff(7): Fix comma splice.G. Branden Robinson2023-04-091-1/+1
|
* groff(7): Tighten wording.G. Branden Robinson2023-04-091-1/+1
| | | | Fix orphaned partial word and buy a vee for a forthcoming commit.
* groff(7): Add "Punning names" section.G. Branden Robinson2023-04-091-25/+27
| | | | We have a "Diversions" section for it to follow now.
* groff(7): Fix internal cross reference.G. Branden Robinson2023-04-091-1/+1
| | | | Use correct lettercase.
View Lorry Controller Status