From mboxrd@z Thu Jan 1 00:00:00 1970 From: Alan Coopersmith Subject: Re: [PATCH libdrm 0/4] Overview man-pages for libdrm Date: Mon, 24 Sep 2012 22:41:56 +0100 Message-ID: <5060D3A4.9060504@oracle.com> References: <1348411208-3943-1-git-send-email-dh.herrmann@googlemail.com> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii"; Format="flowed" Content-Transfer-Encoding: 7bit Return-path: Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by gabe.freedesktop.org (Postfix) with ESMTP id 43CF39E76A for ; Mon, 24 Sep 2012 14:42:55 -0700 (PDT) In-Reply-To: <1348411208-3943-1-git-send-email-dh.herrmann@googlemail.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: dri-devel-bounces+sf-dri-devel=m.gmane.org@lists.freedesktop.org Errors-To: dri-devel-bounces+sf-dri-devel=m.gmane.org@lists.freedesktop.org To: David Herrmann Cc: dri-devel@lists.freedesktop.org List-Id: dri-devel@lists.freedesktop.org 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