aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2021-01-21 12:08:33 +0100
committerMichael Kerrisk <mtk.manpages@gmail.com>2021-01-21 12:10:36 +0100
commitfe1ab0bcc9a99c02c558d919445cd0772535ae18 (patch)
tree2ef6eacae9abef9860639dbaca4d9d6316cdd7a4
parentcd415e7364fd6cf0a22bd1b86c9122f72bb6a0d4 (diff)
downloadman-pages-fe1ab0bcc9a99c02c558d919445cd0772535ae18.tar.gz
man-pages.7: Note some rationale for the use of real minus signs
See: https://lore.kernel.org/linux-man/20210121061158.5ul7226fgbrmodbt@localhost.localdomain/ From: "G. Branden Robinson" <g.branden.robinson@gmail.com> Cc: linux-man <linux-man@vger.kernel.org>, groff@gnu.org Subject: Re: Escaping hyphens ("real" minus signs in groff) Date: Thu, 21 Jan 2021 17:12:00 +1100 and also groff_char(7). Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r--man7/man-pages.710
1 files changed, 10 insertions, 0 deletions
diff --git a/man7/man-pages.7 b/man7/man-pages.7
index b7fbdb7d60..0e70827146 100644
--- a/man7/man-pages.7
+++ b/man7/man-pages.7
@@ -920,6 +920,16 @@ use the following form in the man page source:
.PP
This guideline applies also to code examples.
.PP
+The use of real minus signs serves the following purposes:
+.\" https://lore.kernel.org/linux-man/20210121061158.5ul7226fgbrmodbt@localhost.localdomain/
+.IP * 3
+To provide better renderings on various targets other than
+ASCII terminals,
+notably in PDF and on Unicode/UTF\-8-capable terminals.
+.IP *
+To generate glyphs that when copied from rendered pages will
+produce real minus signs when pasted into a terminal.
+.PP
To produce unslanted single quotes that render well in ASCII, UTF-8, and PDF,
use "\e(aq" ("apostrophe quote"); for example
.PP