More storage format remarks

David Faure dfaure at klaralvdalens-datakonsult.se
Tue Jun 15 20:21:51 CEST 2004


<recurrence> : <month> is the full month name (june in the example). Wouldn't it
be simpler for everyone to use month numbers instead?

4.2.3: the first example says type="None", instead of "none" I suppose.

The whole notion of ranges isn't very well defined. "none" means all the time,
"number" is the number of times the recurrence happens, and "date" is... ah
the ending date. Found from the examples, but a line about it before,
would be a good idea :)

4.2: it says <exclusion> but the examples say <exception>. I guess it's the latter?

Is the version attribute (for notes, events etc.) mandatory or optional?

All types (note, event etc.) refer to <attachment> at the end of the list
of fields that are common to all types, but that field isn't defined in 4.1
(nor anywhere else?)

4.1: says last-modification-date. But Chapter 5 and following say "last-modified".
4.1 is in fact not really normative, I noticed that the default values etc. are specified
in the definition of each of the type. I suspect it might be clearer to fully define
the common fields in 4.1. (e.g. default value for sensitivity, etc.)

Chapter 6: under the xml, it says "in a contact, the body is the note". Which note?
Copy-n-paste error, or does this mean some random text associated with the contact?

Chapter 6: in the XML, there's <email> twice, at two levels. This is error prone
and hard to model in e.g. DTDs (although it's no problem in RelaxNG). So if needed
we can keep it, but it looks a bit unclean. Not sure what to suggest... raw-email
for the inner one?

Note done yet with the schema, but it's in good progress. Will commit it, as well
as test files and a script to run the test, to the "doc" cvs module.

-- 
David Faure -- faure at kde.org, dfaure at klaralvdalens-datakonsult.se
Qt/KDE/KOffice developer
Klarälvdalens Datakonsult AB, Platform-independent software solutions




More information about the format mailing list