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.
The patch has a minor error. The second .EX macro should be an .EE.
Sorry about the phenomenal bug spam, guys. Adding xorg-team@ to the QA contact so bugs don't get lost in future.
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.