diff options
| author | Ingo Schwarze <schwarze@openbsd.org> | 2023-10-23 22:57:54 +0000 |
|---|---|---|
| committer | Ingo Schwarze <schwarze@openbsd.org> | 2023-10-23 22:57:54 +0000 |
| commit | 8a8bc122106d3c6164977db2ba5b07c3e2bf359d (patch) | |
| tree | c8b34458a1de05992cfab88ca1a2f462d1a32a2d | |
| parent | 18c87ef68c91b81051bd58c31019aa7c8983ce80 (diff) | |
| download | mandoc-8a8bc122106d3c6164977db2ba5b07c3e2bf359d.tar.gz | |
Remove the statement that .TQ was "rarely used even in GNU manual pages".
It appears the Linux Manual Pages project started to quite aggressively
use .TQ ever for cases where it not only provides no value, but makes
formatting worse even when it formats as intended. It's also a bad idea
to use it that aggressively because .TQ has particularly catastrophic
formatting behaviour on formatters (other than groff and mandoc) that do
not support it: It essentially has the effect of omitting the topic of
the discussion from the formatted version of the manual page, but in
such a way that it does not become apparent to the reader that anything
is missing.
But whether this is wise or stupid is their problem and none of our
business. Either way, we should not call a thing "rarely used"
after that is no longer true.
Thanks to Alejandro Colomar <alx at kernel org org>
for making me aware that the statement is no longer true.
| -rw-r--r-- | man.7 | 6 |
1 files changed, 3 insertions, 3 deletions
@@ -1,7 +1,7 @@ -.\" $Id$ +.\" $Id$ .\" .\" Copyright (c) 2009, 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv> -.\" Copyright (c) 2011-2015, 2017-2020 Ingo Schwarze <schwarze@openbsd.org> +.\" Copyright (c) 2011-2015,2017-2020,2023 Ingo Schwarze <schwarze@openbsd.org> .\" Copyright (c) 2017 Anthony Bentley <bentley@openbsd.org> .\" Copyright (c) 2010 Joerg Sonnenberger <joerg@netbsd.org> .\" @@ -440,7 +440,7 @@ unspecified, the saved or default width is used. Like .Ic TP , except that no vertical spacing is inserted before the paragraph. -This is a GNU extension and rarely used even in GNU manual pages. +This is a GNU extension. .It Ic UC Sets the volume for the footer for compatibility with man pages from .Bx |