Carsten Ziegeler wrote:
> 
> > David Crossley wrote:
> >
> > There are some aspects of the document set that need attention
> > - uniform XML declarations and Document Type Declarations.
> > When these two issues are resolved, then i will create the
> > CVS diffs for all relevant xdocs.
> >
> > Here are the 4 unique values for XML declaration from all 85 xdocs.
> > ----
> > <?xml version="1.0"?>
> > <?xml version="1.0" encoding="utf-8"?>
> > <?xml version="1.0" encoding="iso-8859-1"?>
> > <?xml version="1.0" encoding="ISO-8859-1" ?>
> > ----
> > Which one do we settle on?
> >
> I would suggest the fifth solution:
> <?xml version="1.0" encoding="UTF-8"?>
> 
> > Here are the 4 unique values for Document Type Declaration
> > from all relevant docs.
> > ----
> > <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
> > "dtd/document-v10.dtd">
> > <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Vx.yz//EN"
> > "dtd/document-v10.dtd">
> > <!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
> > <!DOCTYPE document SYSTEM "dtd/document-v10.dtd">
> > ----
> > IMHO the first is the best. What do you think?.
> >
> +1 for the first one.

Hmmm, not so sure.

IMHO, since C2 now has a catalog system, why don't we use it?

Then the best identifier should be something like:

 <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
  "http://www.apache.org/dtd/document-v10.dtd";>

but this will require the entire ASF to be aware of this and I'm not
sure I have the political power to push this so high.

Second choice something like

 <!DOCTYPE document PUBLIC "-//APACHE//XML//DTD Documentation V1.0//EN"
  "http://xml.apache.org/dtd/document-v10.dtd";>

but still we have to have the PMC approuval for this.

Third option (but this doesn't work without an appropriate catalog) is

 <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
  "document-v10.dtd">

The forth option is to use XSchema and forget about DTD altogher, given
also the need to include other namespaces such as SVG and OpenOffice.

one thing is for sure: we have to uniform the declaration and make the
document building process fully validating.

comments?

-- 
Stefano Mazzocchi      One must still have chaos in oneself to be
                          able to give birth to a dancing star.
<[EMAIL PROTECTED]>                             Friedrich Nietzsche
--------------------------------------------------------------------


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

Reply via email to