be consistent with man page suffixes
David Nusinow
dnusinow at speakeasy.net
Tue Jan 23 17:57:48 PST 2007
On Tue, Jan 23, 2007 at 10:56:39AM -0600, Jeremy C. Reed wrote:
> I see libXi was patched for
> https://bugs.freedesktop.org/show_bug.cgi?id=7855
>
> It appears it was decided that the suffix "should be 3 for everyone". For
> example:
>
> .SH "SEE ALSO"
> -XGrabDevice(3X11)
> +XGrabDevice(3)
>
> But we still have the __LIB_MAN_SUFFIX__ that can be customized (and if I
> read it right, it is "3x" for Linux and Debian's BSD).
>
> This should be done consistent. Either always use one section name or
> always use the macro.
>
> Is there another bug report about this?
>
> On a related note, see https://bugs.freedesktop.org/show_bug.cgi?id=6600
>
> Any comments? (Or explanation?)
I think it's a bug. I've been patching manpages to use the macro as I go,
but I haven't put a real strong effort in to finishing the job. I think
just using the macro in every package is definitely the right move, and it
was the general consensus when I asked about it on irc a while back.
>From the Debian point of view, having the macro available so that we can
easily support both the linux and bsd ports is a bonus.
- David Nusinow
More information about the xorg
mailing list