OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help



   Re: Using notations to identify content formats

[ Lists Home | Date Index | Thread Index ]
  • From: John Cowan <cowan@locke.ccil.org>
  • To: XML Dev <xml-dev@ic.ac.uk>
  • 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@ccil.org
	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@ic.ac.uk
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@ic.ac.uk the following message;
(un)subscribe xml-dev
To subscribe to the digests, mailto:majordomo@ic.ac.uk the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa@ic.ac.uk)


News | XML in Industry | Calendar | XML Registry
Marketplace | Resources | MyXML.org | Sponsors | Privacy Statement

Copyright 2001 XML.org. This site is hosted by OASIS