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

Re: Comments within DTDs

• From: Chris Maden <crism@o...>
• To: xml-dev@i...
• Date: Thu, 9 Apr 1998 11:53:28 -0400

[Steve Robertson]
> One thing missing from the syntax of ATTLIST declarations is support
> for comments. This would have provided helpful clues if updating old
> schemas at some time in the future.
> 
> Has this been a case of simplicity being given preference over
> readiblity (!), Or is there an historical reason behind the lack of
> such provisions?

It's for simplicity, but I don't feel it affects readability.  The way
I comment XML DTDs is thus:

<!-- thiselement: a sample element -->
<!ELEMENT thiselement (contentmodel)>
<!-- id:       unique identifier for the element
     role:     one of
               good:  looks like Toshiro Mifune
               bad:   looks like Clint Eastwood
               ugly:  looks like Paula Jones
     whatever: I don't care; put something here -->
<!ATTLIST thiselement
          id       ID              #IMPLIED
          role     (good|bad|ugly) "good"
          whatever CDATA           #REQUIRED>

HTH,
Chris
-- 
<!NOTATION SGML.Geek PUBLIC "-//Anonymous//NOTATION SGML Geek//EN">
<!ENTITY crism PUBLIC "-//O'Reilly//NONSGML Christopher R. Maden//EN"
"<URL>http://www.oreilly.com/people/staff/crism/ <TEL>+1.617.499.7487
<USMAIL>90 Sherman Street, Cambridge, MA 02140 USA" NDATA SGML.Geek>

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...)

• References:
  • Comments within DTDs
    • From: "Steve Robertson" <stever@o...>

• Prev by Date: Comments within DTDs
• Next by Date: Re: When is an attribute an attribute?
• Previous by thread: Comments within DTDs
• Next by thread: Re: Comments within DTDs (Teapot not tempest)
• Index(es):
  • Date
  • Thread