Hello dear ant users,

I have a suggestion for <xmlcatalog/>.

Currently, in ANT 1.5Beta1 XML Catalogs are defined like this:
<xmlcatalog id="generalcatalog">
    <dtd
        publicId="-//W3C//DTD XHTML Basic 1.0//EN"
        location="src/dtds/xhtml-basic/xhtml-basic10.dtd"
    />
    <dtd
        publicId="-//W3C//DTD XHTML Stylesheets 1.0//EN"
        location="src/dtds/xhtml-modularization/DTD/xhtml-style-1.mod"
    />
    <dtd
        publicId="-//W3C//ELEMENTS Module Qualified Names Template 1.0//EN"
        location="src/dtds/xhtml-modularization/DTD/templates/template-qname-1.mod"
    />
    <dtd
        publicId="-//W3C//ELEMENTS XHTML BDO Element 1.0//EN"
        location="src/dtds/xhtml-modularization/DTD/xhtml-bdo-1.mod"
    />
    <dtd
        publicId="-//W3C//ELEMENTS XHTML Base Architecture 1.0//EN"
        location="src/dtds/xhtml-modularization/DTD/xhtml-arch-1.mod"
    />
    <dtd
        publicId="-//W3C//ELEMENTS XHTML Base Element 1.0//EN"
        location="src/dtds/xhtml-modularization/DTD/xhtml-base-1.mod"
    />
    <dtd
        publicId="-//W3C//ELEMENTS XHTML Basic Forms 1.0//EN"
        location="src/dtds/xhtml-modularization/DTD/xhtml-basic-form-1.mod"
    />
    <!-- ... -->
</xmlcatalog>

I suggest to change the name of the nested dtd element to entity.

The reason is that
1. It is possible to reference files that are not an external subset of a DTD, but 
simply included entities, like the modules in XHTML Modularization.
2. The DTD is part of the document. The files ending on dtd are just files usually 
used as the external subset of a document type definition.
3. The class used in Java to do this is named EntityResolver, not DTDResolver.
So for three reasons the name dtd for the nested element is semantically wrong.


If you agree, I suggest to change it immediatly, before using the <dtd/>-element 
becomes common practice.


Greetings and have a nice day.

-- 
Christian Wolfgang Hujer
Geschäftsführender Gesellschafter
ITCQIS GmbH
Telefon: +49 (089) 27 37 04 37
Telefax: +49 (089) 27 37 04 39
E-Mail: mailto:[EMAIL PROTECTED]
WWW: http://www.itcqis.com/


--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to