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