[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: The XML spec in XML: missing tags

• From: "Eve L. Maler" <elm@a...>
• To: Xml-Dev <xml-dev@i...>
• Date: Wed, 25 Feb 1998 10:47:57 -0500

Oh, you want *documentation*, do you??  Well, the DTD was hard to write; it
should be hard to understand. :-)

Seriously, I keep saying that I'll release the reference documentation Real
Soon Now, and in fact I'm hoping to be able to spend a few hours tidying it
up and releasing it later this week.  (There's also a minor DTD update in
the pipe.)

At 03:32 AM 2/25/98 -0500, Peter Murray-Rust wrote:
>My interest is similar - but complementary - to Michael's; I am interested
>in the terminology. Thus I want to be able to abstract the terms [there are
>62 termdefs] in the document and produce a model for their structure (e.g.
>entailment by containment, by linking and so on.) In this way I can create
>a graphical interactive map of the concepts in the XML spec and have
>already created a prototype. I would like to know, for example, whether all
>terms are defined by <termdef> or whether there are some which are simply
>defined by <term>foo bar</term>. There appears to be some duplication here
>as well; thus a termdef has an attribute naming the term, but it is also
>often contained within a <term> later in the 'description'.  [And there is
>at least one case where </termdef> occurs in mid-sentence - I suspect this
>isn't intended.]

<termdef> is a really odd way to do term definitions, for my money, but
that's what the users wanted. :-)  It captures an "inline" definition of a
term, and because of the mixed content model, it can't even ensure that a
<term> is present to identify the actual term being defined.  Likewise, it
can't ensure that the definition captured functions as a "standalone"
sentence or set of sentences.  I suspect that the cut-off sentence was more
in the spirit of poetic license.

<term> is occasionally used legitimately without a <termdef> wrapper; it's
marking a term being used in a special way, without an accompanying
definition.

Gee, maybe I should just collect all the questions and do the documentation
as a Q&A...

	Eve

xml-dev: A list for W3C XML Developers. To post, mailto:xml-dev@i...
Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/
To (un)subscribe, mailto:majordomo@i... the following message;
(un)subscribe xml-dev
To subscribe to the digests, mailto:majordomo@i... the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa@i...)

• Follow-Ups:
  • Re: The XML spec in XML: missing tags
    • From: Peter Murray-Rust <peter@u...>

• References:
  • Re: The XML spec in XML: missing tags
    • From: "Eve L. Maler" <elm@a...>

• Prev by Date: Re: SAX: finalising org.sax.xml.Parser
• Next by Date: Re: SAX: finalising org.sax.xml.Parser
• Previous by thread: Re: The XML spec in XML: missing tags
• Next by thread: Re: The XML spec in XML: missing tags
• Index(es):
  • Date
  • Thread