Re: [PATCH libdrm 0/4] Overview man-pages for libdrm

From: Alan Coopersmith <alan.coopersmith@oracle.com>
To: David Herrmann <dh.herrmann@googlemail.com>
Cc: dri-devel@lists.freedesktop.org
Subject: Re: [PATCH libdrm 0/4] Overview man-pages for libdrm
Date: Mon, 24 Sep 2012 22:41:56 +0100	[thread overview]
Message-ID: <5060D3A4.9060504@oracle.com> (raw)
In-Reply-To: <1348411208-3943-1-git-send-email-dh.herrmann@googlemail.com>

On 09/23/12 03:40 PM, David Herrmann wrote:
> Hi
>
> This tries to continue the effort to document libdrm. I actually removed the
> X11-like man-page generation code as autotools now support man_MANS. The
> previous approach required every manpage to be in the same man-group. However,
> API calls belong in man3 and overview pages into man7. So I just use the simpler
> approach without all the replacements. It turns out, no man-page did use them so
> we can add it again if one really needs them.

The X.Org rules were made to handle distros & OS'es using different man
sections.  For instance, on System V OS'es (including Solaris), overview man
pages go in section 5, drivers in section 7.   Linux adopted the BSD section
numbers, so this is much less interesting for libdrm than it was for XFree86
and X.Org back in the day, since we can just patch Solaris into working and
let upstream use the common section numbers for the rest.

-- 
	-Alan Coopersmith-              alan.coopersmith@oracle.com
	 Oracle Solaris Engineering - http://blogs.oracle.com/alanc