Date: Sun, 9 Mar 2003 23:06:46 -0800 From: Sean Chittenden <sean@chittenden.org> To: "M. Warner Losh" <imp@bsdimp.com> Cc: trhodes@FreeBSD.org, dwmalone@FreeBSD.org, src-committers@FreeBSD.org, cvs-src@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/sys/dev/kbd kbd.c Message-ID: <20030310070646.GR79234@perrin.int.nxad.com> In-Reply-To: <20030309.233634.116607012.imp@bsdimp.com> References: <20030309225156.7c1ecc11.trhodes@FreeBSD.org> <20030309.213022.95786550.imp@bsdimp.com> <20030310062717.GQ79234@perrin.int.nxad.com> <20030309.233634.116607012.imp@bsdimp.com>
next in thread | previous in thread | raw e-mail | index | archive | help
> And tunables that are not co-located with devices are a big pain > too. > > Maybe we need to have an automatically generated cross reference > page. Any takers? <can_of_worms>While updating the handbook to include a bit on what would trigger an 'sfbufa' state, it struck me as pretty silly to have to update the man page and the handbook and any other place that mentioned sendfile/NSFBUFS/sfbufa. Having to keep DocBook sources in sync with a man page is a bit crazy given the vast richness that DocBook provides. Seems as though a one time conversion of man pages into DocBook articles is in order and then the docbook pages could be automatically converted to man pages and referenced anywhere in the project in a consistent way. I know there are XSL formatting issues with doing this, but the quality of the markup in the man pages would be consistent and we'd have a centrally referencable data source on tunables and other misc intricate places of the system. As a perk, this'd get doc updates out of the src tree.</can_of_worms> I'm 90% done with a DTD and markup for SA's, if this were done in XML DocBook, I'd be game for taking this up. I might even go so far as writing the XSL to handle DocBook->man page. Baring that, I'm sure cat/set/awk'ing together some text files much the same way that LINT is generated would work. Is there any build time or man page equiv of a server side include? Would it be worth extending man to have the ability to include the text of an external mdoc source? -sc -- Sean Chittenden To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030310070646.GR79234>