<feed xmlns='http://www.w3.org/2005/Atom'>
<title>delta/groff-git.git, branch master</title>
<subtitle>git.savannah.gnu.org: git/groff.git
</subtitle>
<link rel='alternate' type='text/html' href='http://trove.baserock.org/cgit/delta/groff-git.git/'/>
<entry>
<title>doc/groff.texi: Revise discussion of `ce` request.</title>
<updated>2023-05-18T03:29:30+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-18T03:25:13+00:00</published>
<link rel='alternate' type='text/html' href='http://trove.baserock.org/cgit/delta/groff-git.git/commit/?id=1b5a9554b42f4bd4f95069088c62c78c0657f0be'/>
<id>1b5a9554b42f4bd4f95069088c62c78c0657f0be</id>
<content type='text'>
Also adjust dead-tree pagination.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Also adjust dead-tree pagination.
</pre>
</div>
</content>
</entry>
<entry>
<title>doc/groff.texi: Clarify discussion of `ec` &amp; `eo`.</title>
<updated>2023-05-18T03:24:47+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-18T03:24:47+00:00</published>
<link rel='alternate' type='text/html' href='http://trove.baserock.org/cgit/delta/groff-git.git/commit/?id=604bf4072baef5e122ed35e019af84579134568a'/>
<id>604bf4072baef5e122ed35e019af84579134568a</id>
<content type='text'>
Also shift some forward references into footnotes.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Also shift some forward references into footnotes.
</pre>
</div>
</content>
</entry>
<entry>
<title>groff_diff(7): Fix missing punctuation.</title>
<updated>2023-05-17T23:48:44+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-17T23:48:44+00:00</published>
<link rel='alternate' type='text/html' href='http://trove.baserock.org/cgit/delta/groff-git.git/commit/?id=f57623a6b98af04b4e9426c1a14f7edd3380573f'/>
<id>f57623a6b98af04b4e9426c1a14f7edd3380573f</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>groff_mm(7): Fix content, style, and markup nits.</title>
<updated>2023-05-17T22:25:28+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-17T20:43:24+00:00</published>
<link rel='alternate' type='text/html' href='http://trove.baserock.org/cgit/delta/groff-git.git/commit/?id=a2b4c1382bde523ce2fe522d17f289809be60c86'/>
<id>a2b4c1382bde523ce2fe522d17f289809be60c86</id>
<content type='text'>
Content:
* Document that AF can end a TL-initiated title as AU can.
* Describe AF's behavior when specified multiple times.
* Add cross references in AF, macro descriptions.
* Clarify that AT interacts with letters.
* Cross-reference LI and LE macros in all list-beginning macro
  descriptions.
* Drop explicit documentation of how some macros handle empty arguments
  are handled when this information is presented in a table; these
  already list "none", and the introduction to the "Macros" section
  explains how to explicitly pass empty macro arguments.
* When discussing "compatibility reasons", identify what we're trying to
  be compatible with (DWB mm).
* Stop reporting values of string defaults in macro descriptions; these
  are properly documented in the "Strings" section.
* Begin more macro descriptions with meaningful imperative statements.
  Stop bending into pretzel shapes trying to make these expansions of an
  abbreviation that the macro name encodes.
* Stop associating `FC` with MT memoranda; they don't use it.  (The
  internal macro `let@mt-closing` appears to be misleadingly named.)
* Explain what the second argument to `FD` does.
* Drop synopses of hook macros in favor of their descriptions in the
  in the macros that call them.  (Except for EOP and TP, which demand
  further consideration before recasting because they are called by
  traps, which aren't otherwise described.)
* Drop example from `IND` macro description; it communicated nothing
  that isn't said as well in prose.
* Document `Rf` string.
* Document `Ref` register and its use by the IND macro.

Style:
* Format macro names without leading dot.
* Recast descriptions of macros 1C, AF, AL, AT, AU, AV, AVL, BL, BS,
  BVL, COVER, COVEND, DF, DL, DS, FC, FD, FE, FS, H, HY, HZ, IA, IE,
  IND, INDP, INITI, LB, LC, LE, LI, LO, LT, MULB, ND, nP, NS, PGFORM,
  PGNH, RL, RS, SM, TL, VL, WA, and WE; and Verbnm string.
* Fix comma splice (BE).
* Parallelize wording, particularly when macros or diversions are used
  to collect input.
* Stop further indenting tables and code displays in macro descriptions.
  Aligning them with the paragraphs suffices.
* Set "none" in italics when presenting tables of parameter meanings.
* In tables, use sentences more and fragments less.
* Use more idiomatic English.
* Fix fractured wording (mine, I think) in EQ description.
* More consistently capitalize table column headings when they aren't
  metasyntactic variables.
* Fix subject/verb agreement in Le/Lf/Lt/Lx register description.

Markup:
* Use \~ instead of \space in macro synopses.
* Use \c and font alternation macros instead of \f in macro synopses.
* Use tbl(1) more idiomatically when presenting lists of strings
  available to EOP and TP macros.
* Adjust dead-tree pagination with `br` and `ne` requests.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Content:
* Document that AF can end a TL-initiated title as AU can.
* Describe AF's behavior when specified multiple times.
* Add cross references in AF, macro descriptions.
* Clarify that AT interacts with letters.
* Cross-reference LI and LE macros in all list-beginning macro
  descriptions.
* Drop explicit documentation of how some macros handle empty arguments
  are handled when this information is presented in a table; these
  already list "none", and the introduction to the "Macros" section
  explains how to explicitly pass empty macro arguments.
* When discussing "compatibility reasons", identify what we're trying to
  be compatible with (DWB mm).
* Stop reporting values of string defaults in macro descriptions; these
  are properly documented in the "Strings" section.
* Begin more macro descriptions with meaningful imperative statements.
  Stop bending into pretzel shapes trying to make these expansions of an
  abbreviation that the macro name encodes.
* Stop associating `FC` with MT memoranda; they don't use it.  (The
  internal macro `let@mt-closing` appears to be misleadingly named.)
* Explain what the second argument to `FD` does.
* Drop synopses of hook macros in favor of their descriptions in the
  in the macros that call them.  (Except for EOP and TP, which demand
  further consideration before recasting because they are called by
  traps, which aren't otherwise described.)
* Drop example from `IND` macro description; it communicated nothing
  that isn't said as well in prose.
* Document `Rf` string.
* Document `Ref` register and its use by the IND macro.

Style:
* Format macro names without leading dot.
* Recast descriptions of macros 1C, AF, AL, AT, AU, AV, AVL, BL, BS,
  BVL, COVER, COVEND, DF, DL, DS, FC, FD, FE, FS, H, HY, HZ, IA, IE,
  IND, INDP, INITI, LB, LC, LE, LI, LO, LT, MULB, ND, nP, NS, PGFORM,
  PGNH, RL, RS, SM, TL, VL, WA, and WE; and Verbnm string.
* Fix comma splice (BE).
* Parallelize wording, particularly when macros or diversions are used
  to collect input.
* Stop further indenting tables and code displays in macro descriptions.
  Aligning them with the paragraphs suffices.
* Set "none" in italics when presenting tables of parameter meanings.
* In tables, use sentences more and fragments less.
* Use more idiomatic English.
* Fix fractured wording (mine, I think) in EQ description.
* More consistently capitalize table column headings when they aren't
  metasyntactic variables.
* Fix subject/verb agreement in Le/Lf/Lt/Lx register description.

Markup:
* Use \~ instead of \space in macro synopses.
* Use \c and font alternation macros instead of \f in macro synopses.
* Use tbl(1) more idiomatically when presenting lists of strings
  available to EOP and TP macros.
* Adjust dead-tree pagination with `br` and `ne` requests.
</pre>
</div>
</content>
</entry>
<entry>
<title>groff_mm(7): Fix sorting errors.</title>
<updated>2023-05-17T11:37:25+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-17T06:24:04+00:00</published>
<link rel='alternate' type='text/html' href='http://trove.baserock.org/cgit/delta/groff-git.git/commit/?id=d40f92de58edcc4c185a6c1399e05b420c528b82'/>
<id>d40f92de58edcc4c185a6c1399e05b420c528b82</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>groff_mm(7): Flesh out introduction.</title>
<updated>2023-05-15T04:58:14+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-15T04:56:48+00:00</published>
<link rel='alternate' type='text/html' href='http://trove.baserock.org/cgit/delta/groff-git.git/commit/?id=615663789606d210265d80830deda040796d2020'/>
<id>615663789606d210265d80830deda040796d2020</id>
<content type='text'>
Survey some major features to give the reader without a copy of the DWB
mm manual handy a means of entry to this huge package.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Survey some major features to give the reader without a copy of the DWB
mm manual handy a means of entry to this huge package.
</pre>
</div>
</content>
</entry>
<entry>
<title>groff_mm(7): Improve localization guidance.</title>
<updated>2023-05-15T04:58:14+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-15T04:37:49+00:00</published>
<link rel='alternate' type='text/html' href='http://trove.baserock.org/cgit/delta/groff-git.git/commit/?id=4d9481f1ffd3d416c6477a161e526135bdbecdc9'/>
<id>4d9481f1ffd3d416c6477a161e526135bdbecdc9</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>groff_mm(7): Improve introduction to package.</title>
<updated>2023-05-15T04:58:14+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-15T04:32:54+00:00</published>
<link rel='alternate' type='text/html' href='http://trove.baserock.org/cgit/delta/groff-git.git/commit/?id=6018637c1a805f5cb2b45513b50d8a0c49b17754'/>
<id>6018637c1a805f5cb2b45513b50d8a0c49b17754</id>
<content type='text'>
* Express requirement that an mm(7) macro be called to initialize the
  package.
* Relocate advise regarding simple mm documents earlier, and further
  simplify.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* Express requirement that an mm(7) macro be called to initialize the
  package.
* Relocate advise regarding simple mm documents earlier, and further
  simplify.
</pre>
</div>
</content>
</entry>
<entry>
<title>NEWS: Update item about ms's `DD` register.</title>
<updated>2023-05-15T04:58:14+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-15T04:28:26+00:00</published>
<link rel='alternate' type='text/html' href='http://trove.baserock.org/cgit/delta/groff-git.git/commit/?id=9589e6fe04641b67f6a86f5e877b432a93a90f6a'/>
<id>9589e6fe04641b67f6a86f5e877b432a93a90f6a</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>[ms]: Fix content nits in documentation.</title>
<updated>2023-05-15T04:58:10+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-14T06:32:03+00:00</published>
<link rel='alternate' type='text/html' href='http://trove.baserock.org/cgit/delta/groff-git.git/commit/?id=1c39f5d80d047969a4a8b52ab3284ccfed0f88bb'/>
<id>1c39f5d80d047969a4a8b52ab3284ccfed0f88bb</id>
<content type='text'>
* Explicitly tell the reader how to end section heading text.
* Describe the handling of display distance in more detail.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* Explicitly tell the reader how to end section heading text.
* Describe the handling of display distance in more detail.
</pre>
</div>
</content>
</entry>
</feed>
