Lists Home |
Date Index |
- From: Chris Maden <email@example.com>
- To: firstname.lastname@example.org
- Date: Thu, 9 Apr 1998 11:53:28 -0400
> 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 -->
id ID #IMPLIED
role (good|bad|ugly) "good"
whatever CDATA #REQUIRED>
<!NOTATION SGML.Geek PUBLIC "-//Anonymous//NOTATION SGML Geek//EN">
<!ENTITY crism PUBLIC "-//O'Reilly//NONSGML Christopher R. Maden//EN"
<USMAIL>90 Sherman Street, Cambridge, MA 02140 USA" NDATA SGML.Geek>
xml-dev: A list for W3C XML Developers. To post, mailto:email@example.com
Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/
To (un)subscribe, mailto:firstname.lastname@example.org the following message;
To subscribe to the digests, mailto:email@example.com the following message;
List coordinator, Henry Rzepa (mailto:firstname.lastname@example.org)