Bug 9652 - Bad markup in XDrawArc.3x
Summary: Bad markup in XDrawArc.3x
Status: RESOLVED FIXED
Alias: None
Product: xorg
Classification: Unclassified
Component: Lib/Xlib (show other bugs)
Version: unspecified
Hardware: x86 (IA32) Linux (All)
: high normal
Assignee: Xorg Project Team
QA Contact: Xorg Project Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-01-14 10:40 UTC by Eric S. Raymond
Modified: 2007-08-21 15:20 UTC (History)
0 users

See Also:
i915 platform:
i915 features:


Attachments

Description Eric S. Raymond 2007-01-14 10:40:27 UTC
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
and .in in favor of requests like .nf/.fi, and .RS/.RE that have
structural translations.

2. TBL markup not used where it should be.  Tables stitched together
with .ta requests can't be lifted to DocBook and will often
choke third-party viewers such as TKMan, XMan, Rosetta, etc.

--- XDrawArc.3x-orig	2007-01-14 02:18:05.000000000 -0500
+++ XDrawArc.3x	2007-01-14 02:20:34.000000000 -0500
@@ -142,6 +142,16 @@
 .el .sp 10p
 ..
 .ny0
+.de EX
+.sp
+.nf
+.ft CW
+..
+.de EE
+.ft R
+.fi
+.sp
+..
 '\" e
 .TH XDrawArc 3X11 "libX11 1.0.3" "X Version 11" "XLIB FUNCTIONS"
 .SH NAME
@@ -240,13 +250,12 @@
 returns a value in the range % [ - pi over 2 , ~pi over 2  ] %
 and adjust is:
 .LP
-.Ds
-.TA 1i 2i
-.ta 1i 2i
+.TS
+l l.
 %0%	for normal-angle in the range % [ 0 , ~pi over 2  ]%
 %pi%	for normal-angle in the range % [ pi over 2 , ~{3 pi} over 2  ]%
 %2 pi%	for normal-angle in the range % [ {3 pi} over 2 , ~2 pi  ]%
-.De
+.TE
 .LP
 For any given arc, 
 .ZN XDrawArc
@@ -295,15 +304,13 @@
 .ZN XArc
 structure contains:
 .LP
-.Ds 0
-.TA .5i 3i
-.ta .5i 3i
+.EX
 typedef struct {
 	short x, y;
 	unsigned short width, height;
 	short angle1, angle2;             /\(** Degrees * 64 */
 } XArc;
-.De
+.EX
 .LP
 All x and y members are signed integers.
 The width and height members are 16-bit unsigned integers.
Comment 1 Eric S. Raymond 2007-01-26 12:09:11 UTC
The patch has a minor error.  The second .EX macro should be an .EE.
Comment 2 Daniel Stone 2007-02-27 01:35:44 UTC
Sorry about the phenomenal bug spam, guys.  Adding xorg-team@ to the QA contact so bugs don't get lost in future.
Comment 3 Alan Coopersmith 2007-08-21 15:20:37 UTC
Thanks for the fix - checked in the corrected version to git master:

commit 9d3ceea4b902e0471824c1e07ad64342b9a1114e
Author: Eric S. Raymond <esr@thyrsus.com>
Date:   Sun Jan 14 10:40:00 2007 -0800

    Bug #9652: Bad markup in XDrawArc.3x
    
    X.Org Bugzilla #9652 <https://bugs.freedesktop.org/show_bug.cgi?id=9652>


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.