Skip site navigation (1)Skip section navigation (2)
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-src" 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>