This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [docbook] How to display a directory tree


See this message for my take on the name:

http://lists.oasis-open.org/archives/docbook/200201/msg00011.html

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net


----- Original Message ----- 
From: "Rune Enggaard Lausen" <rune@enggaard-lausen.dk>
To: "John L. Clark" <jclark@nps.edu>
Cc: <docbook@lists.oasis-open.org>
Sent: Wednesday, April 20, 2005 2:01 PM
Subject: Re: [docbook] How to display a directory tree


> John L. Clark wrote:
> > Tangentially, this brings up a slight nit that I have with DocBook.  I
> > think that the variablelist element is misnamed.  I think the idea of
> > the "definition list" that is present in HTML is a closer fit to the
> > common uses of this type of list.  In a hypothetical definition list,
> > one could still "define" variables (and so we can still represent
> > variable lists), but we can also "define" anything that requires
> > defining (such as the structure of a directory in this case).  But of
> > course, such a change would be Significantly Backwards Incompatible(tm).
>
> I interpret the word "variable" as referring to the fact that the
> "item indicator" is not fixed. In itemizedlist they are "fixed" in the
> sense that they are always a kind of bullet. In orderedlist they are
> "fixed" in the sense that they are always a kind of number. In
> variablelist the author herself decides what the indicator is.
>
> Don't know if this interpretation was the original intent, but it
> helps me explain the name to new users at work :-)
>
> Best regards,
>
> Rune Lausen
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
>
>
>



---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]