Bug 35050

Summary: Broken crossreferences in Xt manpages
Product: xorg Reporter: Cyril Brulebois <kibi>
Component: Lib/XtAssignee: Xorg Project Team <xorg-team>
Status: RESOLVED FIXED QA Contact: Xorg Project Team <xorg-team>
Severity: normal    
Priority: medium CC: memsize
Version: git   
Hardware: Other   
OS: All   
URL: http://bugs.debian.org/512130
Whiteboard:
i915 platform: i915 features:

Description Cyril Brulebois 2011-03-05 19:34:26 UTC 
From my reply to Debian bug #512130 (http://bugs.debian.org/512130):

--8<--
Ian Zimmerman <itz@buug.org> (17/01/2009):
> Hi, the Xt manpages are installed in section 3 (and not 3Xt as
> upstream would have it). But, internal cross-references (in
> particular, in the SEE ALSO part) are left alone, and keep pointing
> at Foo(3Xt).  The result is that they can't be automatically
> followed from manpage sanitizers such as dwww or emacs.

there's a macro which should help: __libmansuffix__. It's already used
all over the place, but not yet completely:
| $ git grep __libmansuffix__ man/*.man|wc -l
| 267
| $ git grep 3Xt man/*.man|wc -l
| 87

A single regex might be sufficient to get everything sorted out.
-->8--

Opening a bug here so that it doesn't get forgotten about. An easy target for a newcomer, I guess.
Comment 1 Alan Coopersmith 2011-03-06 09:31:37 UTC 
While Gaetan isn't a newcomer, he has been fixing a lot of these bugs in the
Xorg man pages recently, so cc'ing him.
Comment 2 Gaetan Nadon 2011-03-06 10:56:57 UTC 
Patch is out for review on xorg-devel

-XtAppAddActions(3Xt)
+XtAppAddActions(__libmansuffix__)

I get the same count, "87" of them.
Comment 3 Gaetan Nadon 2011-03-08 04:29:11 UTC 
Fixed in commit f6c791b5f318d8805db4cb6c74b1bc2e91d6c15c

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.