Bug 9518

Summary:	Markup problems on the xdpr.1 page
Product:	xorg	Reporter:	Eric S. Raymond <esr>
Component:	App/other	Assignee:	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:14:37 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 xdpr.1x:

1. Unknown or invalid macro.  That is, one that does not fit in the
macro set that the man page seems to be using.  This is a serious
error; it often means part of your text is being lost or rendered
incorrectly.

2. Unescaped \d looks like a troff down-motion.  This probably messes
up the rendering of the page in some environments, and certainly
confuses automated translation to XML.

--- xdpr.1x-orig	2006-12-20 00:51:42.000000000 -0500
+++ xdpr.1x	2006-12-20 00:53:06.000000000 -0500
@@ -57,7 +57,7 @@
 with the \fI\-device\fP option.
 .TP
 .B \-display \fIhost:display\fP[\fI.screen\fP]
-.cm .IB host : display
+.IB host : display
 Normally,
 .I xdpr
 gets the host and display number to use from the environment
@@ -73,9 +73,9 @@
 Digital LA100
 .TP
 .B ljet
-\s-1HP\s+1 LaserJet series and other monochrome PCL devices
+HP LaserJet series and other monochrome PCL devices
 such as ThinkJet, QuietJet, RuggedWriter, \s-1HP\s+12560 series,
-and \s-1HP\s+12930 series printers
+and HP 2930 series printers
 .TP
 .B ln03
 Digital LN03
@@ -126,7 +126,7 @@
 PRINTER
 which printer to use by default.
 .SH COPYRIGHT
-Copyright ([\d,\s]*) X Consortium
+Copyright X Consortium
 .br
 See \fIX(1)\fP for a full statement of rights and permissions.
 .SH AUTHORS
-----------------------------

Comment 1 Alan Coopersmith 2007-01-02 19:05:05 UTC

Thanks for the fix - the .cm line looks redundant though, so I've dropped it
altogether and applied the rest of your patch to git master:

commit 9049071794e0cdf8d72851f52481e053f6d21ca4
Author: Eric S. Raymond <esr@thyrsus.com>
Date:   Tue Jan 2 19:03:09 2007 -0800

    Bug 9518: Markup problems on the xdpr.1 page
    
    <https://bugs.freedesktop.org/show_bug.cgi?id=9518>

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.