Bug 35050

Summary:	Broken crossreferences in Xt manpages
Product:	xorg	Reporter:	Cyril Brulebois <kibi>
Component:	Lib/Xt	Assignee:	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.