Date: Mon, 26 Aug 2002 01:52:58 +0200 From: Christian Brueffer <chris@unixpages.org> To: Giorgos Keramidas <keramida@FreeBSD.org> Cc: freebsd-doc@FreeBSD.org Subject: Re: <releaseinfo> vs <pubdate> in books/fdp-primer/sgml-markup/chapter.sgml Message-ID: <20020825235258.GA805@unixpages.org> In-Reply-To: <20020825155620.GD1988@hades.hell.gr> References: <20020813205741.GR14281@unixpages.org> <20020825155620.GD1988@hades.hell.gr>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, Aug 25, 2002 at 06:56:20PM +0300, Giorgos Keramidas wrote:
>
> The Docbook Guide describes the two very shortly as:
>
> pubdate - The date of publication of a document
> releaseinfo - Information about a particular release of a document
>
> This sounds very similar, at first glance. In fact, the two are
> identical for online documents, like the FreeBSD documentation.
> My guess is that pubdate is meant for books that are typeset, and
> printed the way "real world" books are, where an edition is made
> public every now and then. The releaseinfo description matches my
> idea of what an online document is. A document that is constantly
> updated and new releases of it become available as changes are
> committed to the document repository.
>
Nice explanation, I agree with it. So, I guess if no one objects, following patch
could be committed:
--- chapter.sgml Sun Aug 18 19:26:25 2002
+++ chapter.sgml.modified Mon Aug 26 01:48:09 2002
@@ -794,9 +794,7 @@
<holder role="mailto:<replaceable>your e-mail address</replaceable>"><replaceable>Your name</replaceable></holder>
</copyright>
- <pubdate role="rcs">$Date$</pubdate>
-
- <releaseinfo>$Id$</releaseinfo>
+ <releaseinfo>$FreeBSD$</releaseinfo>
<abstract>
<para><replaceable>Include an abstract of the book's contents here.</replaceable></para>
@@ -845,9 +843,7 @@
<holder role="mailto:<replaceable>your e-mail address</replaceable>"><replaceable>Your name</replaceable></holder>
</copyright>
- <pubdate role="rcs">$Date$</pubdate>
-
- <releaseinfo>$Id$</releaseinfo>
+ <releaseinfo>$FreeBSD$</releaseinfo>
<abstract>
<para><replaceable>Include an abstract of the article's contents here.</replaceable></para>
- Christian
--
http://www.unixpages.org chris@unixpages.org
GPG Pub-Key : www.unixpages.org/cbrueffer.asc
GPG Fingerprint: 0DB5 8563 2473 C72A A8D1 56EA DAD2 B05D 5F3C 3185
GPG Key ID : DAD2B05D5F3C3185
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020825235258.GA805>