Bug 9519

Summary: Markup problems in xfontsel.1x and xlsfonts.1x
Product: xorg Reporter: Eric S. Raymond <esr>
Component: App/otherAssignee: Xorg Project Team <xorg-team>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: high    
Version: unspecified   
Hardware: x86 (IA32)   
OS: Linux (All)   
Whiteboard:
i915 platform: i915 features:

Description Eric S. Raymond 2007-01-02 09:40:02 UTC
See http://catb.org/~esr/doclifter/problems.html for details on how and
why these patches were generated.  Feel free to email me with any questions.

Problems with xfontsel.1x:

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, TkMan, Rosetta, and
the KDE help browser.

--- xfontsel.1x-orig	2007-01-01 18:07:04.000000000 -0500
+++ xfontsel.1x	2007-01-01 18:08:05.000000000 -0500
@@ -219,11 +219,11 @@
 The average-width menu is too large to be useful.
 .SH COPYRIGHT
 Copyright 1989, 1991,  X Consortium
-.br
+.PP
 See \fIX(7)\fP for a full statement of rights and permissions.
 .SH AUTHOR
 .PP
 Ralph R. Swick, Digital Equipment Corporation/MIT Project Athena
-.br
+.PP
 Mark Leisher <mleisher@crl.nmsu.edu> added the support for the UTF-8 sample
 text.
-----------------------------
Problems with xlsfonts.1x:

1. Use of low-level troff hackery to set special indents or breaks can't
be translated. See above.

--- xlsfonts.1x-orig	2006-12-20 06:31:50.000000000 -0500
+++ xlsfonts.1x	2006-12-20 06:34:32.000000000 -0500
@@ -4,20 +4,11 @@
 xlsfonts \- server font list displayer for X
 .SH SYNOPSIS
 .ad l
-\fBxlsfonts\fR \kx
-.if (\nxu > (\n(.lu / 2)) .nr x (\n(.lu / 5)
-'in \n(.iu+\nxu
+\fBxlsfonts\fR
 [\fB\-display \fBhost:dpy\fR\fR] [\fB\-l\fR] [\fB\-ll\fR] [\fB\-lll\fR]
[\fB\-m\fR] [\fB\-C\fR] [\fB\-1\fR] [\fB\-w \fBwidth\fR\fR] [\fB\-n
\fBcolumns\fR\fR] [\fB\-u\fR] [\fB\-o\fR] [\fB\-fn \fBpattern\fR\fR]
-'in \n(.iu-\nxu
-.ad b
-.PP
-.ad l
-\fBxlsfonts\fR \kx
-.if (\nxu > (\n(.lu / 2)) .nr x (\n(.lu / 5)
-'in \n(.iu+\nxu
+.br
+\fBxlsfonts\fR
 \fB\-printer \fBprintername\fR\fR [\fB\-l\fR] [\fB\-ll\fR] [\fB\-lll\fR]
[\fB\-m\fR] [\fB\-C\fR] [\fB\-1\fR] [\fB\-w \fBwidth\fR\fR] [\fB\-n
\fBcolumns\fR\fR] [\fB\-u\fR] [\fB\-o\fR] [\fB\-r \fBresolution\fR\fR]
[\fB\-b\fR] [\fB\-B\fR] [\fB\-g\fR] [\fB\-G\fR] [\fB\-x \fBmode\fR\fR] [\fB\-X
\fBmode\fR\fR] [\fB\-fn \fBpattern\fR\fR]
-'in \n(.iu-\nxu
-.ad b
 .SH DESCRIPTION
 xlsfonts lists the fonts that match the given pattern.
 The wildcard character "*" may be used to match any sequence of characters
-----------------------------
Comment 1 Alan Coopersmith 2007-01-02 19:17:30 UTC
Thanks for the fixes - committed to their respective git master repositories:

commit a109dc6867135b8dcdb4a32d016dba96fc42b1fa
Author: Eric S. Raymond <esr@thyrsus.com>
Date:   Tue Jan 2 19:10:31 2007 -0800

    Bug 9519: Markup problems in xfontsel.1x
    
    <https://bugs.freedesktop.org/show_bug.cgi?id=9519>

commit d77488aa710457262bed09302efe8ead9c4e3c8e
Author: Eric S. Raymond <esr@thyrsus.com>
Date:   Tue Jan 2 19:16:13 2007 -0800

    Bug 9519: Markup problems in xlsfonts.1x
    
    <https://bugs.freedesktop.org/show_bug.cgi?id=9519>

(The previous xlsfonts hackery also broke display with Solaris nroff.)

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.