Re: Handling of updates to kernel Documentation/ tree

[Stephan Mueller <stephan.mueller-fwYZOkdEjagAvxtiuMwx3w@public.gmane.org>]

Am Dienstag, 10. März 2015, 07:11:04 schrieb Christoph Hellwig:

Hi Christoph,

>On Mon, Mar 09, 2015 at 01:40:57PM -0400, Mike Frysinger wrote:
>> > Referencing a kernel Documentation file from a man page sounds like
>> > a bad idea to me.  Why can't we include a nroff-yfied version of
>> > the
>> > content in the man-pages repository?
>> 
>> isn't that way worse ?  now we have to keep the man pages git repo in
>> sync with the kernel Documentation/ subtree.
>
>The content really should not change that much for public APIs.
>
>> i think having the man pages refer to the public docbook kernel.org
>> pages should be fine.
>
>Pointing to kernel.org posted html renderings sounds perfectly fine to
>me.  The reference to files inside a kernel source tree is what I
>object to.
>--
>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

If this is the consensus, then I will wait with a patch to the man page 
until the code is merged into Linus' tree and the DocBook at kernel.org 
is updated.

The patch will then refer to the precise kernel.org web page.


Ciao
Stephan
--
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