Bug 9513 - Unknown macro in editres.1x
Summary: Unknown macro in editres.1x
Status: RESOLVED FIXED
Alias: None
Product: xorg
Classification: Unclassified
Component: App/other (show other bugs)
Version: unspecified
Hardware: x86 (IA32) Linux (All)
: high normal
Assignee: Xorg Project Team
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-01-02 08:08 UTC by Eric S. Raymond
Modified: 2007-01-02 18:43 UTC (History)
0 users

See Also:
i915 platform:
i915 features:


Attachments

Description Eric S. Raymond 2007-01-02 08:08:49 UTC
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.

--- editres.1x-orig	2006-12-18 10:50:25.000000000 -0500
+++ editres.1x	2006-12-18 10:50:54.000000000 -0500
@@ -175,7 +175,6 @@
 \fIflashColor\fP.
 .sp
 .nf
-.TA .5i 1.5i 4.0i
 .ta .5i 1.5i 4.0i
 	\fBKey	Option	Translation Entry\fP
 
@@ -343,7 +342,6 @@
 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
 Editres  editres
 	Paned  paned
Comment 1 Eric S. Raymond 2007-01-02 13:57:36 UTC
This patch is a better fix.  It turns the ad-hoc table into real table markup,
removes sum untranslatable breaks, and cleans up some abuses of .IP.

--- editres.1x-orig	2007-01-02 16:37:58.000000000 -0500
+++ editres.1x	2007-01-02 16:38:23.000000000 -0500
@@ -121,34 +121,21 @@
 but this mechanism does give very useful feedback between the elements
 in the widget tree and those in the actual application.
 .IP "Select All" 
-.br
-.ns 
 .IP "Unselect All"
-.br
-.ns 
 .IP "Invert All" 
 These functions allow the user to select, unselect, or invert all
 widgets in the widget tree.
 .IP "Select Children"
-.br
-.ns 
 .IP "Select Parents"
 These functions select the immediate parent or children of each of the
 currently selected widgets.
 .IP "Select Descendants"
-.br
-.ns 
 .IP "Select Ancestors"
 These functions select all parents or children of each of the
 currently selected widgets.  This is a recursive search.
 .IP "Show Widget Names"
-.br
-.ns 
 .IP "Show Class Names"
-.br
-.ns .IP "Show Widget IDs"
-.br
-.ns 
+.IP "Show Widget IDs"
 .IP "Show Widget Windows"
 When the tree widget is initially displayed the labels of each widget
 in the tree correspond to the widget names.  These functions will
@@ -174,25 +161,25 @@
 application \fInumFlashes\fP (three by default) times in the
 \fIflashColor\fP.
 .sp
-.nf
-.TA .5i 1.5i 4.0i
-.ta .5i 1.5i 4.0i
-	\fBKey	Option	Translation Entry\fP
-
-	space	Unselect	Select(nothing)
-	w	Select	Select(widget)
-	s	Select	Select(all)
-	i	Invert	Select(invert)
-	c	Select Children	Select(children)
-	d	Select Descendants	Select(descendants)
-	p	Select Parent	Select(parent)
-	a	Select Ancestors	Select(ancestors)
-	N	Show Widget Names	Relabel(name)
-	C	Show Class Names	Relabel(class)
-	I	Show Widget IDs	Relabel(id)
-	W	Show Widget Windows	Relabel(window)
-	T	Toggle Widget/Class Name	Relabel(toggle)
-.fi
+.TS
+lb lb lb
+l l l.
+Key	Option	Translation Entry
+-
+space	Unselect	Select(nothing)
+w	Select	Select(widget)
+s	Select	Select(all)
+i	Invert	Select(invert)
+c	Select Children	Select(children)
+d	Select Descendants	Select(descendants)
+p	Select Parent	Select(parent)
+a	Select Ancestors	Select(ancestors)
+N	Show Widget Names	Relabel(name)
+C	Show Class Names	Relabel(class)
+I	Show Widget IDs	Relabel(id)
+W	Show Widget Windows	Relabel(window)
+T	Toggle Widget/Class Name	Relabel(toggle)
+.TE
 .sp
 Clicking button 1 on a widget adds it to the set of selected widgets.
 Clicking button 2 on a widget deselects all other widgets and then
@@ -219,7 +206,7 @@
 The last line contains a set of special buttons called \fBAny
 Widget Chain\fP which will turn the single level into something that
 matches zero or more levels.
-.IP ""
+.sp
 The initial state of this area is the most restrictive, using the
 resource names and the dot separator.  By selecting the other buttons
 in this area you can ease the restrictions to allow more and more widgets
@@ -237,18 +224,15 @@
 should be entered exactly as you would type a line into your resource file.
 Thus it should contain no unescaped new-lines.  There are a few
 special character sequences for this file:
-.IP ""
+.sp
 \\n - This will be replaced with a newline.
-.br
 .sp
 \\### - Where # is any octal digit.  This will be replaced with a
 single byte that contains this sequence interpreted as an octal number.
 For example, a value containing a NULL byte can be stored by
 specifying \\000.
-.br
 .sp
 \\<new-line> - This will compress to nothing.
-.br
 .sp
 \\\\ - This will compress to a single backslash.
 .IP "Command Area"
@@ -273,7 +257,7 @@
 a hook has been provided to allow specific applications to
 block these SetValues
 requests (see \fBBlocking Editres Requests\fP below).
-.IP ""
+.sp
 Unfortunately due to design constraints imposed on the widgets by the X
 Toolkit and the Resource Manager, trying to coerce an inherently
 static system into dynamic behavior can cause strange results.  There

Comment 2 Alan Coopersmith 2007-01-02 18:43:56 UTC
Thanks for the fix - committed the second version to git master:

commit f29f6eb20486b84ab0f73dbbc4295a2193fdf451
Author: Eric S. Raymond <esr@thyrsus.com>
Date:   Tue Jan 2 18:43:21 2007 -0800

    Bug 9513: Unknown macro & other formatting fixes in editres.1x
    
    <https://bugs.freedesktop.org/show_bug.cgi?id=9513>



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.