<feed xmlns='http://www.w3.org/2005/Atom'>
<title>delta/groff-git.git/src, branch master</title>
<subtitle>git.savannah.gnu.org: git/groff.git
</subtitle>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/groff-git.git/'/>
<entry>
<title>[man pages]: Revise some syntax synopses.</title>
<updated>2023-05-07T01:07:48+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-07T01:07:48+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/groff-git.git/commit/?id=4cacb755346c2a4159a42e987b26ff8b20dfae7c'/>
<id>4cacb755346c2a4159a42e987b26ff8b20dfae7c</id>
<content type='text'>
Use ellipsis more idiomatically, favoring it over plurals, and including
it within instead of outside option brackets for clarity.

The construction:

foo bar [baz] ...

is ambiguous.  If I specify no "baz", can "bar"s be repeated?

Also say "argument" when we mean an option OR an operand.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Use ellipsis more idiomatically, favoring it over plurals, and including
it within instead of outside option brackets for clarity.

The construction:

foo bar [baz] ...

is ambiguous.  If I specify no "baz", can "bar"s be repeated?

Also say "argument" when we mean an option OR an operand.
</pre>
</div>
</content>
</entry>
<entry>
<title>gropdf(1): Add "Macros" subsection with `pdfinfo`.</title>
<updated>2023-05-06T17:44:36+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-06T17:32:54+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/groff-git.git/commit/?id=75950d1cd5e532b6367251ad593ed97cbfce05ed'/>
<id>75950d1cd5e532b6367251ad593ed97cbfce05ed</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>gropdf(1): Fix more content/style/markup nits.</title>
<updated>2023-05-06T17:40:43+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-05T20:06:16+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/groff-git.git/commit/?id=d383afd962c18a582bb0083ecbe5afe2955394c8'/>
<id>d383afd962c18a582bb0083ecbe5afe2955394c8</id>
<content type='text'>
Content:
* More carefully distinguish escape sequences from device control
  commands; the former are more general.
* The *roff `\X` escape sequence is a device control command, not a
  "special".  *roff already freights the latter term with enough meaning
  without hauling in TeX's use for it.
* The "ps:" or "pdf:" part of a device control command escape sequence
  parameter is the "tag", not the entire parameter.  It is a name
  spacing convention.
* Clarify operation of `xrev` device control command.

Style:
* Recast: all device control commands are "extensions"; there is no
  standard set.
* Convert mentions of (g)pic(1) and grops(1) to man page cross
  references.
* Set pic(1) command names in bold, not italics.
* Set "mom" macro package name in italics, not bold.
* Set "gropdf" in italics, not bold.
* Capitalize "PDF" in prose.
* Protect Perl's "localtime" function name from hyphenation.
* Hyphenate adjectival phrases.
* Hyphenate metasyntactic variable consistently with its introduction.
* Otherwise recast for (attempted) clarity and concision.

Markup:
* Use two empty requests where vertical space is expected.
* Annotate a mismatch in conventions between grotty(1) and gropdf(1).
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Content:
* More carefully distinguish escape sequences from device control
  commands; the former are more general.
* The *roff `\X` escape sequence is a device control command, not a
  "special".  *roff already freights the latter term with enough meaning
  without hauling in TeX's use for it.
* The "ps:" or "pdf:" part of a device control command escape sequence
  parameter is the "tag", not the entire parameter.  It is a name
  spacing convention.
* Clarify operation of `xrev` device control command.

Style:
* Recast: all device control commands are "extensions"; there is no
  standard set.
* Convert mentions of (g)pic(1) and grops(1) to man page cross
  references.
* Set pic(1) command names in bold, not italics.
* Set "mom" macro package name in italics, not bold.
* Set "gropdf" in italics, not bold.
* Capitalize "PDF" in prose.
* Protect Perl's "localtime" function name from hyphenation.
* Hyphenate adjectival phrases.
* Hyphenate metasyntactic variable consistently with its introduction.
* Otherwise recast for (attempted) clarity and concision.

Markup:
* Use two empty requests where vertical space is expected.
* Annotate a mismatch in conventions between grotty(1) and gropdf(1).
</pre>
</div>
</content>
</entry>
<entry>
<title>gropdf(1): Fix content, style, and markup nits.</title>
<updated>2023-05-05T18:58:24+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-05T18:45:23+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/groff-git.git/commit/?id=5cc880e267412101899d9570ad6b7f7a2fd9252d'/>
<id>5cc880e267412101899d9570ad6b7f7a2fd9252d</id>
<content type='text'>
Content:
* Introduce the concept of convenience macros earlier, then rely on it.
* Align terminology regarding page location traps with the rest of
  groff's documentation.
* Align header/footer terminology with the rest of groff's
  documentation.

Style:
* Tighten wording.
* Set macro call literals in bold.
* Use imperative voice more when describing device control commands.
* Present convenience macros _after_ full discussion of device control
  command behavior, not in the midst of it.
* Coalesce some single-sentence paragraphs into their predecessors.

Markup:
* Set file names in italics.
* Protect macro call literals from hyphenation.
* Use an empty request between sentences.
* Use two empty requests where vertical space is expected.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Content:
* Introduce the concept of convenience macros earlier, then rely on it.
* Align terminology regarding page location traps with the rest of
  groff's documentation.
* Align header/footer terminology with the rest of groff's
  documentation.

Style:
* Tighten wording.
* Set macro call literals in bold.
* Use imperative voice more when describing device control commands.
* Present convenience macros _after_ full discussion of device control
  command behavior, not in the midst of it.
* Coalesce some single-sentence paragraphs into their predecessors.

Markup:
* Set file names in italics.
* Protect macro call literals from hyphenation.
* Use an empty request between sentences.
* Use two empty requests where vertical space is expected.
</pre>
</div>
</content>
</entry>
<entry>
<title>gropdf(1): Add gpresent link and description.</title>
<updated>2023-05-05T18:44:41+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-05T18:43:11+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/groff-git.git/commit/?id=53cb0f02691459132fbc9bb6bd1f628883cb1791'/>
<id>53cb0f02691459132fbc9bb6bd1f628883cb1791</id>
<content type='text'>
The page references it several times; we should explain what it is and
link to it.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
The page references it several times; we should explain what it is and
link to it.
</pre>
</div>
</content>
</entry>
<entry>
<title>gropdf(1): Fix pagination nit.</title>
<updated>2023-05-05T18:33:01+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-05T13:34:23+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/groff-git.git/commit/?id=7ce5bad10e2d0f4e1de575c0a876869aa8fa6f73'/>
<id>7ce5bad10e2d0f4e1de575c0a876869aa8fa6f73</id>
<content type='text'>
Drop a paragraph break after a very short paragraph to buy a vee and fix
an orphaned line on U.S. letter paper.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Drop a paragraph break after a very short paragraph to buy a vee and fix
an orphaned line on U.S. letter paper.
</pre>
</div>
</content>
</entry>
<entry>
<title>gropdf(1), pdfmom(1): Update authorship credits.</title>
<updated>2023-05-05T18:33:01+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-05T13:30:09+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/groff-git.git/commit/?id=b0971dc17a11490347e232dcb1cbd21364377a8f'/>
<id>b0971dc17a11490347e232dcb1cbd21364377a8f</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>[man pages]: Adjust dead-tree pagination.</title>
<updated>2023-05-05T18:32:55+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-05T13:05:34+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/groff-git.git/commit/?id=f5e7a13f3ffa29190dfda70502a51625889a5ddf'/>
<id>f5e7a13f3ffa29190dfda70502a51625889a5ddf</id>
<content type='text'>
Also drop an unnecessary paragraph break in glilypond(1).
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Also drop an unnecessary paragraph break in glilypond(1).
</pre>
</div>
</content>
</entry>
<entry>
<title>groff(1): Tighten wording.</title>
<updated>2023-05-05T13:05:10+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-05T13:05:10+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/groff-git.git/commit/?id=8618653e17e630326182debf9d997ac708801aae'/>
<id>8618653e17e630326182debf9d997ac708801aae</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>groff(1), troff(1): Document operand handling.</title>
<updated>2023-05-04T18:12:03+00:00</updated>
<author>
<name>G. Branden Robinson</name>
<email>g.branden.robinson@gmail.com</email>
</author>
<published>2023-05-04T17:56:32+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/groff-git.git/commit/?id=76d816e05295e64bdf500ac4cadaccfe69f655cb'/>
<id>76d816e05295e64bdf500ac4cadaccfe69f655cb</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
</feed>
