A suggestion: how about a namespace identifier to
document your tag vocabulary?
i.e. where it currently writes:
=======
<!-- You may obtain more information about AbiWord at
www.abisource.com -->
[...]
<abiword version="0.7.3">
=======
how about:
<abiword xmlns="http://www.abisource.com/1999/abw-0.7.3">
or:
<abiword xmlns="http://www.abisource.com/1999/abw-0.7.3"
version="0.7.3">
and put some information about the tags at that address...
an XML schema would be really cool.
Is there any documentation on the tags? I tried to UTSL and
I came up with:
http://www.abisource.com/lxr/source/abi/src/wp/impexp/xp/ie_exp_AbiWord_1.cpp
to actually support namespaces, the code that reads the file
shouldn't care what prefix is used; for example, this should work:
<ab:abiword xmlns:ab="http://www.abisource.com/1999/abw-0.7.3"
version="0.7.3">
<ab:section>....</ab:section>
</ab:abiword>
and I suggest that for evolvability, you allow extensions from other
namespaces ala:
<abiword xmlns="http://www.abisource.com/1999/abw-0.7.3"
xmlns:sm="http://my.org/1999/abi-smellovision-extension">
<div sm:smells-like="roses">
...</div>
</abiword>
references:
Namespaces in XML
World Wide Web Consortium 14-January-1999
http://www.w3.org/TR/1999/REC-xml-names-19990114
XML Schema Part 1: Structures
6 May 1999, David Beech, Scott Lawrence, Murray Maloney,
Noah Mendelsohn, Henry S. Thompson
http://www.w3.org/TR/xmlschema-1/
XML Schema Part 2: Datatypes
6 May 1999, Paul V. Biron, Ashok Malhotra
http://www.w3.org/TR/xmlschema-2/
-- Dan Connolly, W3C http://www.w3.org/People/Connolly/