[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: date formats



On Thu, Dec 07, 2000 at 12:31:01PM -0500, David Merrill wrote:
> On Fri, Dec 08, 2000 at 01:21:26AM +0800, Gregory Leblanc wrote:
> > > A recommendation is outlined below; I've extended this as to what
> > > I think would comprise a good/valid MINIMUM set of elements for
> > > a header area for LDP documents:
> > 
> > 
> > Couple of things I'd like to harp on are below.
> > 
> > > ---
> > > 
> > > if linuxdoc:
> > > 
> > >    <title>title of HOWTO, include "HOWTO" or "mini HOWTO"</title>

In linuxdoc there should be no optional end tag </title> to reduce
keystrokes.

> > 
> > 
> > <title>Title of HOWTO, include "HOWTO"</title>
> 
> I agree. Did we ever come to a really final decision on whether or not
> mini is going away? I'm *really*, ***REALLY*** not trying to restart a
> flamefest here; I don't remember. I'll abide by the majority opinion
> once I know what the hell it is. :-)
> 
> > >    <revhistory>
> > >      <revision>
> > >        <revnumber>v2.0</revnumber>
> > >        <date>DD MMM YYYY</date>
> > >      </revision>

Talking about the revision number not inside a <revhistory>
environment: 

What will this be for linuxdoc that has no <revision> tag AFAIK?

I suppose it could be 
<date>v2.0, YYYY MM DD

Then it will need to be automatically conveted to docbook which will
take a little programming work.
Or we could add a <rev> tag to linuxdoc.  Or it might be best to put
both revision and date after the <date> tag in docbook so as to keep
it the same as linuxdoc.

> > > 
> > >      <!-- Additional, *earlier* revision histories go here -->
> > 
> > 
> > I've taken to NOT keeping a complete revision history, but instead just
> > the last few <revision>s.  The complete log is stored in CVS, so I can
> > see the entire history. 
> 
> This seems reasonable to me. The LAG is on about its tenth revision
> already.
> 
> Maybe we should recommend that the revision hierarchy be occasionally
> pruned? Leave major (X.0) revisions and remove .X revisions at some
> point.
> 
> > > More tags *could* be used (<othercredit>, <titleabbrev>, <orgname>,
> > > <copyright>, <authorinitials>, <revremark>, etc.) and perhaps
> > > more should be used, but I see this as being a *minimum*  set of
> > > tags that constitute a valid header area.
> > > 
> > > Please provide comments. As David says, we should get these
> > > guidelines into the style section of the LAG.
> > 
> > 
> > Perhaps we could add the rest of the tags inside of comments <!-- -->,
> > so that they're available, but authors don't feel obligated to use all
> > of those tags?
> 
> I see this as a question of which path we make the "default" and
> therefore the easiest for authors. I think your suggestion makes
> leaving those tags out the path of least resistance, and mine makes
> including them the path of least resistance. IMHO, including them
> should be easier than taking them out. We want them to be used. Of
> course, this depends somewhat on where you draw the line. Tags that
> are really rarely used could go in comments, while the rest do not.
> 
> -- 
> Dr. David C. Merrill                     http://www.lupercalia.net
> Linux Documentation Project                [email protected]
> Collection Editor & Coordinator            http://www.linuxdoc.org
> 
> I used to be a rebel in my youth.
> 
> This cause... that cause... (chuckle) I backed 'em ALL!  But I learned.
> Rebellion is simply a device used by the immature to hide from his own
> problems.  So I lost interest in politics.  Now when I feel aroused by
> a civil rights case or a passport hearing... I realize it's just a device.
> I go to my analyst and we work it out.  You have no idea how much better
> I feel these days.
> 		-- J. Feiffer
> 
> 
> --  
> To UNSUBSCRIBE, email to [email protected]
> with a subject of "unsubscribe". Trouble? Contact [email protected]
> 
> 
			David Lawyer


--  
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]