Re: [docbook] Re: DocBook Technical Committee Meeting Minutes: 30 Jul 2003

[Paul Grosso <pgrosso at arbortext dot com>]

At 14:52 2003 08 18 +0100, David Carlisle wrote:


>  Any idea why David has the suffix "doc" in all the directory
>  names as in "iso8879doc", "mathmldoc", "xhtml1doc"?
>
>
>The directories without "doc" on the end ("iso8879" etc) have xml dtd
>entity declarations in them (.ent files) the ones with doc on the end
>have assorted _doc_umentation, usually in html format.

Ah, that makes sense.  I guess what surprised me was not to find
a pointer to the actual entity declaration files at the top level
page http://www.w3.org/2003/entities/ so I assumed the *doc directories
were all there were.  

>The directory structure will need a complete overhaul anyway once we
>finally decide what exactly should be shipped (eg SGML style SDATA
>entity declaration files, XSLT2 stylesheets specifying the new XSLT2
>character mapping facilty (?)... Of course it's a matter of taste
>whether the different file formats should all be in the same directory
>and distinguished by extension, or in separate directories. I haven't
>any strong feeling about it.

I think I prefer separate directories.  I would expect many people
would want to use a parallel directory structure when snatching a
copy of this, and they may not need/want the doc.  Put another way,
if someone wants all the mathml decls, they should be able to download
a complete directory and have the decls without doc files coming along.

All to say that I don't disagree with your current setup; I might just
suggest some reworking of the file at http://www.w3.org/2003/entities/
so that it's clear that the links under "Entity Sets" aren't, in fact,
to the entity sets, but to documentation.

paul



---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org