Bug 35050 - Broken crossreferences in Xt manpages
Summary: Broken crossreferences in Xt manpages
Status: RESOLVED FIXED
Alias: None
Product: xorg
Classification: Unclassified
Component: Lib/Xt (show other bugs)
Version: git
Hardware: Other All
: medium normal
Assignee: Xorg Project Team
QA Contact: Xorg Project Team
URL: http://bugs.debian.org/512130
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-03-05 19:34 UTC by Cyril Brulebois
Modified: 2011-03-08 04:29 UTC (History)
1 user (show)

See Also:
i915 platform:
i915 features:


Attachments

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.