gbranden pushed a commit to branch master
in repository groff.
commit 1f9c59cc25c439bbb9a3844d0c53b5580f171d8b
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Jun 14 18:05:24 2025 -0500
PROBLEMS: Update man page char remapping item.
* Favor active voice over passive.
* Explain tradeoff involved with remapping ' and `.
---
PROBLEMS | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/PROBLEMS b/PROBLEMS
index e36b8426e..21467b46f 100644
--- a/PROBLEMS
+++ b/PROBLEMS
@@ -60,7 +60,7 @@ following line at each place where you expect the break to
occur.
* When viewing man pages, some characters on my UTF-8 terminal emulator
look funny or copy-and-paste wrong. Why?
-Some Unicode Basic Latin ("ASCII") input characters are mapped to
+GNU troff maps some Unicode Basic Latin ("ASCII") input characters to
non-Basic Latin code points in output for consistency with other output
devices, like PDF. See groff_man_style(7) and groff_char(7) for correct
input conventions and background. If you use the correct groff special
@@ -85,6 +85,10 @@ groff was configured when it was built.
You may also wish to do the same for "mdoc.local".
+However, remapping ' and ` in this manner eliminates the only means of
+inputting directional ("typographer's") quotation marks that is portable
+to AT&T troff. See section "Notes" of groff_man_style(7).
+
In man pages (only), groff maps the minus sign special character '\-' to
the Basic Latin hyphen-minus (U+002D) because man pages require this
glyph and there is no historically established *roff input character,
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
