public inbox for linux-man@vger.kernel.org
 help / color / mirror / Atom feed
From: Russ Allbery <eagle@eyrie.org>
To: Paul Eggert via tz <tz@iana.org>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>,
	Alejandro Colomar <alx.manpages@gmail.com>,
	Paul Eggert <eggert@cs.ucla.edu>,
	linux-man <linux-man@vger.kernel.org>, groff <groff@gnu.org>
Subject: Re: [tz] Doubts about a typo fix
Date: Fri, 25 Nov 2022 19:20:37 -0800	[thread overview]
Message-ID: <87pmdaqu4a.fsf@hope.eyrie.org> (raw)
In-Reply-To: <b91ea285-22f4-5f13-beb2-b0c74cc4db10@cs.ucla.edu> (Paul Eggert via tz's message of "Fri, 25 Nov 2022 18:18:46 -0800")

Paul Eggert via tz <tz@iana.org> writes:

> Thanks for the info about groff. You're right, tzdb man pages are supposed
> to be portable to both groff and traditional troff. For the latter I test
> with /usr/bin/nroff and /usr/bin/troff on Solaris 10, which is the oldest
> troff I know that is still supported.

[...]

> "\f(CW-\fP" is used instead of plain "-" because when the output is PDF,
> it is more clearly visible to humans as a hyphen-minus instead of as a
> hyphen (U+2010 HYPHEN).

You have to be very careful with the combination of \f(CW and \fP on
Solaris 10 nroff, and I suspect the construct you are using has nascent
bugs.  \f(CW doesn't produce a font change on Solaris 2.6 with nroff, so
if you write something like:

    \fBsomething\fP \f(CW-\fP something else

you will discover that "something else" is in bold because the second \fP
reverts to the "previous" font, which nroff thinks is \fB becuase \f(CW
was ignored.  (Just tested now on a Solaris 10 host.)  Pod::Man has fairly
elaborate workarounds for this bug.

>> I also note that "CW" is an old, AT&T device-independent
>> troff-compatible font name.[3] groff's preferred name for this face is
>> "CR", because for the past couple of decades a monospace font (often
>> Courier) has generally been available in all four styles (roman,
>> oblique, bold, and bold-oblique).

> Thanks, I didn't know that was preferred. I installed the attached patch
> into the tzdb development repository

Just be warned that \f(CR is not a valid font name in all *roff
implementations, which is why Pod::Man uses \f(CW by default.  Not sure
how much you care.  (And, to be honest, not sure how much anyone should
care about any implementations other than groff and mandoc these days.)

-- 
Russ Allbery (eagle@eyrie.org)             <https://www.eyrie.org/~eagle/>

  reply	other threads:[~2022-11-26  3:30 UTC|newest]

Thread overview: 17+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-11-23 19:31 Doubts about a typo fix Alejandro Colomar
2022-11-23 21:40 ` G. Branden Robinson
2022-11-26  2:18   ` Paul Eggert
2022-11-26  3:20     ` Russ Allbery [this message]
2022-11-26  3:50       ` [tz] " Paul Eggert
2022-11-26 20:44         ` G. Branden Robinson
2022-11-26  3:52     ` G. Branden Robinson
2022-11-26 12:33       ` Deri
2022-11-26 21:01       ` Paul Eggert
2022-11-26 21:56         ` G. Branden Robinson
2022-11-27  1:58           ` Deri
2022-11-27  2:32           ` Paul Eggert
2022-12-13 19:24             ` G. Branden Robinson
2022-12-25 22:07               ` Lennart Jablonka
2022-12-25 23:21                 ` G. Branden Robinson
2022-11-26 21:20       ` Steffen Nurpmeso
2022-11-26 22:07         ` G. Branden Robinson

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87pmdaqu4a.fsf@hope.eyrie.org \
    --to=eagle@eyrie.org \
    --cc=alx.manpages@gmail.com \
    --cc=eggert@cs.ucla.edu \
    --cc=g.branden.robinson@gmail.com \
    --cc=groff@gnu.org \
    --cc=linux-man@vger.kernel.org \
    --cc=tz@iana.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox