Hi Pádraig, One small thing I noticed while looking over this patch.
Pádraig Brady <p...@draigbrady.com> writes: > +Three input formats are supported. Either the "untagged" output format, > +the "tagged" output format, or the BSD reversed mode format > +which is similar to the "untagged" output format This makes Texinfo emit the following: Either the "untagged" output format, the "tagged" But using, for example, ``untagged'' will emit: Either the “untagged” output format, the “tagged” So, ``...'' will use U+201C (LEFT DOUBLE QUOTATION MARK) and U+201D (RIGHT DOUBLE QUOTATION MARK). I checked both HTML and PDF outputs. The Unicode characters look much better, in my opinion, especially in the PDF. Since it seems ``...'' is more common than "..." in the manual anyways, this patch felt obvious enough to commit right away. Collin
>From 1535ac272e20c6f2deb84e037d95a4148515d566 Mon Sep 17 00:00:00 2001 Message-ID: <1535ac272e20c6f2deb84e037d95a4148515d566.1751338609.git.collin.fu...@gmail.com> From: Collin Funk <collin.fu...@gmail.com> Date: Mon, 30 Jun 2025 19:50:58 -0700 Subject: [PATCH] doc: use ``...'' instead of "..." * doc/coreutils.texi (split invocation): Use ``...'' for quoting text. (cksum common options): Likewise. (Control): Likewise. --- doc/coreutils.texi | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/doc/coreutils.texi b/doc/coreutils.texi index d7a94e5f8..d49976775 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -3540,7 +3540,7 @@ @node split invocation 10 @end example -Use the "l/" modifier to suppress that: +Use the ``l/'' modifier to suppress that: @example $ seq -w 6 10 > k; split -nl/3 k; head xa? @@ -3556,7 +3556,7 @@ @node split invocation 10 @end example -Use the "r/" modifier to distribute lines in a round-robin fashion: +Use the ``r/'' modifier to distribute lines in a round-robin fashion: @example $ seq -w 6 10 > k; split -nr/3 k; head xa? @@ -3573,7 +3573,7 @@ @node split invocation @end example You can also extract just the Kth chunk. -This extracts and prints just the 7th "chunk" of 33: +This extracts and prints just the 7th ``chunk'' of 33: @example $ seq 100 > k; split -nl/7/33 k @@ -4219,9 +4219,9 @@ @node cksum common options with the legacy output format from the @samp{sysv}, @samp{bsd}, @samp{crc} or @samp{crc32b} algorithms. -Three input formats are supported. Either the "untagged" output format, -the "tagged" output format, or the BSD reversed mode format -which is similar to the "untagged" output format +Three input formats are supported. Either the ``untagged'' output format, +the ``tagged'' output format, or the BSD reversed mode format +which is similar to the ``untagged'' output format but doesn't use a character to distinguish binary and text modes. @xref{cksum output modes} for details of these formats. @@ -15332,7 +15332,7 @@ @node Control @cindex stick parity @cindex mark parity @cindex space parity -Use "stick" (mark/space) parity. If parodd is set, the parity bit is +Use ``stick'' (mark/space) parity. If parodd is set, the parity bit is always 1; if parodd is not set, the parity bit is always zero. Non-POSIX@. May be negated. -- 2.50.0