From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Michael Kerrisk (man-pages)" Subject: Re: Handling of updates to kernel Documentation/ tree Date: Tue, 10 Mar 2015 06:56:37 +0100 Message-ID: <54FE8795.4090809@gmail.com> References: <3421611.4D45Q2BAys@tauon> <20150309150739.GA6131@infradead.org> <54FDC468.40503@gmail.com> <20150309160520.GA28067@infradead.org> Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit Return-path: In-Reply-To: <20150309160520.GA28067-wEGCiKHe2LqWVfeAwA7xHQ@public.gmane.org> Sender: linux-man-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org To: Christoph Hellwig Cc: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org, Stephan Mueller , Michael Kerrisk , linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org List-Id: linux-man@vger.kernel.org On 03/09/2015 05:05 PM, Christoph Hellwig wrote: > On Mon, Mar 09, 2015 at 05:03:52PM +0100, Michael Kerrisk (man-pages) wrote: >> Actually, a lot of man pages do refer to kernel Documentation files. >> What's the problem? > > It's not easily accessibe and coherent information. It requires a > checked out kernel tree (or a web mirror these days), which might > be a different version than you expect. Referencing actually installed > case documentation like man page or at least info pages is a lot easier > for the user. I agree that installed documentation is preferable, but sometimes it's not always practical to get that documentation in the desired form. So, failing that man-pages does quite often reference kernel source files. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/ -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org More majordomo info at http://vger.kernel.org/majordomo-info.html