Problems in editres.1, libinput.4, s3.4, xlogo.1, Xserver.1, xterm.1

esr at thyrsus.com esr at thyrsus.com
Tue Jun 12 19:16:14 UTC 2018


This is automatically generated email about markup problems in a man
page for which you appear to be responsible.  If you are not the right
person or list, please tell me so I can correct my database.

See http://catb.org/~esr/doclifter/bugs.html for details on how and
why these patches were generated.  Feel free to email me with any
questions.  Note: These patches do not change the modification date of
any manual page.  You may wish to do that by hand.

I apologize if this message seems spammy or impersonal. The volume of
markup bugs I am tracking is over five hundred - there is no real
alternative to generating bugmail from a database and template.

--
                             Eric S. Raymond
-------------- next part --------------
Problems with xterm.1:

List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
Common causes include .TP just before a section header, .TP entries
with tags but no bodies, and mandoc lists with no trailing .El.
These confuse doclifter, and may also mess up stricter man-page
browsers like Xman and Rosetta.

Use of low-level troff hackery to set special indents or breaks can't
be translated. The page will have rendering faults in HTML, and
probably also under third-party man page browsers such as Xman,
Rosetta, and the KDE help browser.  This patch eliminates .br, .ta, .ti,
.ce, .in, and \h in favor of requests like .RS/.RE that have
structural translations.

--- xterm.1-unpatched	2018-05-18 16:08:09.334001544 -0400
+++ xterm.1	2018-05-18 16:10:36.353002395 -0400
@@ -5921,17 +5921,19 @@
 Clear the Tektronix window.
 .TP
 .B RESET\fP (resource \fBtekreset\fP)
+Reset the Tektronix window.
 .TP
 .B COPY\fP (resource \fBtekcopy\fP)
+Copy the Tektronix window.
 .RE
 .PP
 Windows:
 .RS
-.TP
+.IP
 .B Show VT Window\fP (resource \fBvtshow\fP)
-.TP
+.IP
 .B Switch to VT Mode\fP (resource \fBvtmode\fP)
-.TP
+.IP
 .B Hide Tek Window\fP (resource \fBtekhide\fP)
 .RE
 .
@@ -6869,13 +6871,13 @@
 by echoing a control sequence computed from the event's line number
 in the screen relative to the current line:
 .sp
-.in +8
+.RS
 ESC ^P
-.in -8
+.RE
 or
-.in +8
+.RS
 ESC ^N
-.in -8
+.RE
 .sp
 according to whether the event is before, or after the current line,
 respectively.
-------------- next part --------------
Problems with libinput.4:

List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
Common causes include .TP just before a section header, .TP entries
with tags but no bodies, and mandoc lists with no trailing .El.
These confuse doclifter, and may also mess up stricter man-page
browsers like Xman and Rosetta.

--- libinput.4-unpatched	2018-05-28 00:12:40.955816597 -0400
+++ libinput.4	2018-05-28 00:12:53.779729445 -0400
@@ -277,7 +277,7 @@
 .BI "libinput Tablet Tool Pressurecurve"
 4 32-bit float values [0.0 to 1.0]. See section
 .B TABLET TOOL PRESSURE CURVE
-.TP7
+.TP 7
 .BI "libinput Tablet Tool Area Ratio"
 2 32-bit values, corresponding to width and height. Special value 0, 0
 resets to the default ratio. See section
-------------- next part --------------
Problems with editres.1:

Use of low-level troff hackery to set special indents or breaks can't
be translated. The page will have rendering faults in HTML, and
probably also under third-party man page browsers such as Xman,
Rosetta, and the KDE help browser.  This patch eliminates .br, .ta, .ti,
.ce, .in, and \h in favor of requests like .RS/.RE that have
structural translations.

--- editres.1-unpatched	2014-03-20 11:30:15.000000000 -0400
+++ editres.1	2014-03-20 11:30:14.000000000 -0400
@@ -326,8 +326,7 @@
 is given first, followed by the widget instance name.
 .sp
 .nf
-.TA .5i 1.0i 1.5i 2.0i
-.ta .5i 1.0i 1.5i 2.0i
+.\" the dafault tab stops T 0.8i will work here
 Editres  editres
 	Paned  paned
 		Box  box
-------------- next part --------------
Problems with s3.4:

Use of low-level troff hackery to set special indents or breaks can't
be translated. The page will have rendering faults in HTML, and
probably also under third-party man page browsers such as Xman,
Rosetta, and the KDE help browser.  This patch eliminates .br, .ta, .ti,
.ce, .in, and \h in favor of requests like .RS/.RE that have
structural translations.

--- s3.4-unpatched	2012-08-10 08:37:52.936469789 -0400
+++ s3.4	2012-08-10 08:38:15.176469364 -0400
@@ -50,9 +50,9 @@
 
 .PP
 Also driver supports the following RAMDACs:
-.TP 12
+.IP 12
 .B IBM 524, IBM 524A, IBM 526, IBM 526DB
-.TP 12
+.IP 12
 .B TI ViewPoint 3025 
 
 .SH DESCRIPTION
-------------- next part --------------
Problems with xlogo.1:

Use of low-level troff hackery to set special indents or breaks can't
be translated. The page will have rendering faults in HTML, and
probably also under third-party man page browsers such as Xman,
Rosetta, and the KDE help browser.  This patch eliminates .br, .ta, .ti,
.ce, .in, and \h in favor of requests like .RS/.RE that have
structural translations.

--- xlogo.1-unpatched	2012-07-25 04:35:32.228702714 -0400
+++ xlogo.1	2012-07-25 04:36:00.528702188 -0400
@@ -64,10 +64,10 @@
 is given first, followed by the widget instance name.
 .sp
 .nf
-.TA .5i
-.ta .5i
+.ft CW
 XLogo  xlogo
-	Logo  xlogo
+        Logo  xlogo
+.ft
 .fi
 .sp
 .SH ENVIRONMENT
-------------- next part --------------
Problems with Xserver.1:

Use of low-level troff hackery to set special indents or breaks can't
be translated. The page will have rendering faults in HTML, and
probably also under third-party man page browsers such as Xman,
Rosetta, and the KDE help browser.  This patch eliminates .br, .ta, .ti,
.ce, .in, and \h in favor of requests like .RS/.RE that have
structural translations.

--- Xserver.1-unpatched	2018-05-18 14:15:55.627764185 -0400
+++ Xserver.1	2018-05-18 14:15:55.423765571 -0400
@@ -416,7 +416,7 @@
 Yet another XDMCP specific value, this one allows the display manager to
 identify each display so that it can locate the shared key.
 .SH XKEYBOARD OPTIONS
-X servers that support the XKEYBOARD (a.k.a. \*qXKB\*q) extension accept the
+X servers that support the XKEYBOARD (a.k.a. XKB) extension accept the
 following options.  All layout files specified on the command line must be
 located in the XKB base directory or a subdirectory, and specified as the
 relative path from the XKB base directory.  The default XKB base directory is
@@ -566,7 +566,7 @@
 .fi
 
 This will add /usr/share/X11/fonts/misc as the first FPE with the attribute
-\N'39'unscaled', second FPE will be /usr/share/X11/fonts/75dpi, also with
+\&'unscaled', second FPE will be /usr/share/X11/fonts/75dpi, also with
 the attribute 'unscaled' etc. This is functionally equivalent to setting
 the following font path:
 


More information about the xorg mailing list