On 09 Mar 2015 08:07, Christoph Hellwig wrote: > On Mon, Mar 09, 2015 at 03:17:58PM +0100, Stephan Mueller wrote: > > how shall an update to the Documentation/ tree be handled in man pages > > that contain a pointer to these documents? > > > > Specifically, socket(2) contains a reference to > > Documentation/crypto/crypto-API-userspace.txt. With the patch [1] the > > document is gone and its contents is moved into a DocBook. > > > > Shall the kernel DocBook website [2] be referenced? If so, when is it > > appropriate to add the patch (note, the change is expected to be > > propagated to Linus' tree in 4.1-rc1). > > 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. i think having the man pages refer to the public docbook kernel.org pages should be fine. -mike
Attachment:
signature.asc
Description: Digital signature
