From owner-cvs-src Sun Mar 9 23: 7:59 2003 Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 458B337B401; Sun, 9 Mar 2003 23:07:57 -0800 (PST) Received: from perrin.int.nxad.com (internal.ext.nxad.com [69.1.70.251]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8E3054402A; Sun, 9 Mar 2003 23:07:13 -0800 (PST) (envelope-from sean@perrin.int.nxad.com) Received: by perrin.int.nxad.com (Postfix, from userid 1001) id B37A521068; Sun, 9 Mar 2003 23:06:46 -0800 (PST) Date: Sun, 9 Mar 2003 23:06:46 -0800 From: Sean Chittenden To: "M. Warner Losh" 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> References: <20030309225156.7c1ecc11.trhodes@FreeBSD.org> <20030309.213022.95786550.imp@bsdimp.com> <20030310062717.GQ79234@perrin.int.nxad.com> <20030309.233634.116607012.imp@bsdimp.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030309.233634.116607012.imp@bsdimp.com> User-Agent: Mutt/1.4i X-PGP-Key: finger seanc@FreeBSD.org X-PGP-Fingerprint: 3849 3760 1AFE 7B17 11A0 83A6 DD99 E31F BC84 B341 X-Web-Homepage: http://sean.chittenden.org/ Sender: owner-cvs-src@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG > 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? 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. 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-src" in the body of the message