Subject: Re: AbiWord DTD
From: sam th (email@example.com)
Date: Sat Feb 26 2000 - 00:25:29 CST
-----BEGIN PGP SIGNED MESSAGE-----
On Fri, 25 Feb 2000, Paul Rohr wrote:
> Thanks for the reminders about how useful an *accurate* DTD can be as
> I'm certainly not opposed to documenting the file format. I'm just short on
> time right now to do it myself, and I want to be sure that people know the
> quality of any attempts at documenting it in any way (DTD or not).
> If people prefer to do this in the form of a DTD instead of (or in addition
> to) finishing Jeff's existing description in abi/docs, that's fine too.
Just because pain is so much fun, I think that I could probably also try
tackling the file format document. It doesn't seem that complicated, and
the changes have not been monumental. (that comes soon)
> So, here's a suggestion for how to resolve the debate:
> 1. Fix the DTD. I'm still short on time to review this, but from a quick
> glance there seem to be a lot of bugs here still. For example, I'm pretty
> sure the content model for paragraphs is busted. Also, the fact that P
> PROPS is missing is a big giveaway.
I guess you are short on time. In the DTD, both on my website, and on the
AbiSource site, p has a props attribute. The DTD on my site
is the most current. As it's new, it will keep changing, and of course
the version I have will be ahead of what Bob can keep up on the official
page. I currently have two version, one as standard XML,
and one with some strange SGML constructs to make the W3C validator like
it. Use the standard one.
> 2. Check it into the abi/docs portion of the tree (once it's been fixed).
> This will help emphasize its status as (non-normative) documentation.
> 3. Make it self-documenting. For example, add comments to the top of the
> DTD file itself which explain that it's intended to be descriptive, not
> 4. Add more comments. For example, the DTDs for HTML do a pretty nice job
> of explaining what and how each group of attributes gets used.
> bottom line
> Since Sam's volunteered to maintain the puppy, I think we'll be fine as soon
> as we get a more accurate one.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.1 (GNU/Linux)
Comment: For info see http://www.gnupg.org
-----END PGP SIGNATURE-----
This archive was generated by hypermail 2b25 : Sat Feb 26 2000 - 00:22:23 CST