Bug 9946

Summary: XDrawArc man page maths come out bad on tty
Product: xorg Reporter: Brice Goglin <brice.goglin>
Component: DocumentationAssignee: Xorg Project Team <xorg-team>
Status: RESOLVED MOVED QA Contact: Xorg Project Team <xorg-team>
Severity: minor    
Priority: low    
Version: 7.1 (2006.05)   
Hardware: Other   
OS: All   
URL: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=401944
Whiteboard: 2011BRB_Reviewed
i915 platform: i915 features:

Description Brice Goglin 2007-02-11 01:38:37 UTC
The following bug has been reported to the Debian BTS 2 months ago by Kevin Ryde.

Brice



On a tty, the eqn math bits in "man XDrawArc" come out looking like
	[x+wi2th,y+hei2ht]
or
	2n   for normal-angle in the range [32,2n]
which makes it pretty hard to understand.

Apparently gnu eqn and/or nroff aren't interested in trying to render
maths on a tty.  It'd be nice if XDrawArc could have alternative bits
(".ie n" conditions) that come out better, "[x+width/2,y+height/2]"
and "[3*pi/2,2*pi]" etc.
Comment 1 Daniel Stone 2007-02-27 01:36:20 UTC
Sorry about the phenomenal bug spam, guys.  Adding xorg-team@ to the QA contact so bugs don't get lost in future.
Comment 2 Christopher Yeleighton 2011-07-02 05:25:51 UTC
(In reply to comment #0)
> The following bug has been reported to the Debian BTS 2 months ago by Kevin
> Ryde.
> 
> Brice
> 
> 
> 
> On a tty, the eqn math bits in "man XDrawArc" come out looking like
>     [x+wi2th,y+hei2ht]
> or
>     2n   for normal-angle in the range [32,2n]
> which makes it pretty hard to understand.
> 
> Apparently gnu eqn and/or nroff aren't interested in trying to render
> maths on a tty.  It'd be nice if XDrawArc could have alternative bits
> (".ie n" conditions) that come out better, "[x+width/2,y+height/2]"
> and "[3*pi/2,2*pi]" etc.

Here is the WTF I get in libX11.html#Drawing_Single_and_Multiple_Arcs:

% roman "skewed-angle" ~ = ~ atan left ( tan ( roman "normal-angle" )
 * width over height right ) +^ adjust%

Workaround: { groffer -TX100 XDrawArc; }

Besides, since when do we use full words in mathematical formulas?  It is absurd.  Rather have it medieval-style:

"The tangent of the skewed angle equals the tangent of the normal angle multiplied by the ratio width over height."
Comment 3 Christopher Yeleighton 2011-07-02 07:56:41 UTC
"If two arcs join correctly … XDrawArc does not draw a pixel more than once."

What two arcs??
Comment 4 GitLab Migration User 2018-08-10 21:36:59 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/xorg/lib/libx11/issues/72.

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.