docbook: revison history in DocBook 's
Subject:
Re: revison history in DocBook 's
From:
David Merrill ####@####.####
Date:
27 Mar 2001 16:28:36 -0000
Message-Id: <20010327112726.B27755@lupercalia.net>
On Tue, Mar 27, 2001 at 11:13:58AM -0500, Greg Ferguson wrote:
> DocBook sgml/xml documents filtered to HTML with the current
> DSSSL styles hide the <revhistory>, if the top-level container
> element happens to be <book> (for <article>, the history is
> displayed).
>
> Comparisons:
>
> http://www.linuxdoc.org/HOWTO/SCSI-2.4-HOWTO/
>
> (DocBook SGML, <book>, with a <revhistory> in the SGML)
>
> http://www.linuxdoc.org/HOWTO/mini/Partition/
> http://www.linuxdoc.org/HOWTO/mini/Nvidia-OpenGL-Configuration/
>
> (DocBook SGML, <article>, with a <revhistory> in the SGML)
>
> ---
>
> Anyone have any thoughts or preferences on if this table should
> be shown for <book>'s? I can modify ldp.dsl if it's needed.
>
> Note that if it isn't included, no where in the document will the
> revision number and date be shown unless the author explicitly
> repeats it in another area of the book (e.g. a "record of revision"
> section).
Seems to me we should be consistent unless there is a good reason not
to be, and I can't think of one.
--
Dr. David C. Merrill http://www.lupercalia.net
Linux Documentation Project ####@####.####
Collection Editor & Coordinator http://www.linuxdoc.org
Finger me for my public key
Do you guys know what you're doing, or are you just hacking?