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

Re: Using notations to identify content formats

• From: John Cowan <cowan@l...>
• To: XML Dev <xml-dev@i...>
• Date: Tue, 13 Apr 1999 16:43:39 -0400

Peter Saint-Andre wrote:

> Unfortunately,
> there seems to be a paucity of information regarding how to create
> formal specs for the documentation of notations in XML. Any suggestions
> would be greatly appreciated.

IMHO, natural-language (English, French, or whatever) descriptions
are generally preferred to formal ones, as they are intelligible
to more people and generally "live" longer.

A document that says 

	The MagicDate format is as follows:
	yyyywwd, where yyyy is a zero-padded Gregorian year number,
	ww is a 2-digit week, and d is the day of the week.
	Week 01 of a year is the week containing January 4.
	Day 0 is Sunday, day 6 is Saturday.

does very nicely.  Then you make it retrievable at
http://your.domain/defs/MagicDate.txt and
then declare the notation in your DTDs as

	<!NOTATION MagicDate SYSTEM "http://your.domain/defs/MagicDate.txt">

-- 
John Cowan	http://www.ccil.org/~cowan		cowan@c...
	You tollerday donsk?  N.  You tolkatiff scowegian?  Nn.
	You spigotty anglease?  Nnn.  You phonio saxo?  Nnnn.
		Clear all so!  'Tis a Jute.... (Finnegans Wake 16.5)

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/ and on CD-ROM/ISBN 981-02-3594-1
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: Using notations to identify content formats
    • From: "Peter Saint-Andre" <pstandre@l...>

• References:
  • Using notations to identify content formats
    • From: "Peter Saint-Andre" <pstandre@l...>

• Prev by Date: Re: Congrats Jon Bosak and Tim Bray
• Next by Date: Re: Using notations to identify content formats
• Previous by thread: Using notations to identify content formats
• Next by thread: Re: Using notations to identify content formats
• Index(es):
  • Date
  • Thread