Remove the statement that .TQ was "rarely used even in GNU manual pages".
authorschwarze <schwarze@openbsd.org>
Mon, 23 Oct 2023 22:57:51 +0000 (22:57 +0000)
committerschwarze <schwarze@openbsd.org>
Mon, 23 Oct 2023 22:57:51 +0000 (22:57 +0000)
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.

share/man/man7/man.7

index 31ed7bf..5a2d9ba 100644 (file)
@@ -1,7 +1,7 @@
-.\"    $OpenBSD: man.7,v 1.61 2023/10/07 21:26:29 schwarze Exp $
+.\"    $OpenBSD: man.7,v 1.62 2023/10/23 22:57:51 schwarze Exp $
 .\"
 .\" 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>
 .\"
@@ -17,7 +17,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: October 7 2023 $
+.Dd $Mdocdate: October 23 2023 $
 .Dt MAN 7
 .Os
 .Sh NAME
@@ -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