You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cocoon.apache.org by David Crossley <cr...@indexgeo.com.au> on 2001/09/19 07:13:20 UTC
ensure uniform xdocs/*.xml
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?
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?.
thanks, David Crossley
---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org
AW: ensure uniform xdocs/*.xml
Posted by David Crossley <cr...@indexgeo.com.au>.
Giacomo Pati wrote:
> Stefano Mazzocchi wrote:
> > 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"?>
This XML Declaration is preferred by everyone.
> > > > 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.
Yes Stephano, that would be the best declaration. However,
there is a very good reason for using the default system
identifier "dtd/document-v10.dtd". The catalog manager is
only in effect for Apache Cocoon. The Ant build system
does not have a catalog manager, so it uses brute-force
retrieval to get the DTD for each parse. The use of a
default local system identifier relative to xdocs/ then
allows Ant to do off-line build.
> IIRC we agreed on a simple "http://apache.org/..." month ago for
> namespaces (isn't this like a namespace?)
No Giacomo, the system identifier is not like a namespace.
It is a physical location of the actual entity (either URL
or full pathname or pathname relative to the XML instance).
The public identifier is the symbolic name that can be mapped
by the catalog resolver to some local copy of the resource.
The Apache Cocoon doco catalog.html fully explains all this.
> > 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?
> >
> Well, I don't like DTDs but I don't like XML Schema either (it has grown
> into way too complex specification)
>
> Giacomo
---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org
Re: AW: ensure uniform xdocs/*.xml
Posted by giacomo <gi...@apache.org>.
On Wed, 19 Sep 2001, Stefano Mazzocchi wrote:
> 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">
IIRC we agreed on a simple "http://apache.org/..." month ago for
namespaces (isn't this like a namespace?)
> 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?
Well, I don't like DTDs but I don't like XML Schema either (it has grown
into way too complex specification)
Giacomo
---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org
Re: AW: ensure uniform xdocs/*.xml
Posted by Stefano Mazzocchi <st...@apache.org>.
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.
<st...@apache.org> Friedrich Nietzsche
--------------------------------------------------------------------
---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org
RE: AW: ensure uniform xdocs/*.xml
Posted by Vadim Gritsenko <va...@verizon.net>.
> From: Davanum Srinivas [mailto:dims@yahoo.com]
>
> Sorry....I need to change my vote.
>
> For the XML Declaration:
> > > <?xml version="1.0" encoding="UTF-8"?>
+1
> For the DTD:
> <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
> > > > "dtd/document-v10.dtd">
and +1.
Vadim
>
> Thanks,
> dims
>
>
> --- Davanum Srinivas <di...@yahoo.com> wrote:
> > +1 for the first one.
> > -- dims
> >
> > --- Carsten Ziegeler <cz...@sundn.de> 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.
> > >
> > > Carsten
> > >
> > > > thanks, David Crossley
> > > >
> > > > ---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
> > > > For additional commands, email: cocoon-dev-help@xml.apache.org
> > > >
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
> > > For additional commands, email: cocoon-dev-help@xml.apache.org
> > >
> >
> >
> > =====
> > Davanum Srinivas, JNI-FAQ Manager
> > http://www.jGuru.com/faq/JNI
> >
> > __________________________________________________
> > Terrorist Attacks on U.S. - How can you help?
> > Donate cash, emergency relief information
> > http://dailynews.yahoo.com/fc/US/Emergency_Information/
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
> > For additional commands, email: cocoon-dev-help@xml.apache.org
> >
>
>
> =====
> Davanum Srinivas, JNI-FAQ Manager
> http://www.jGuru.com/faq/JNI
>
> __________________________________________________
> Terrorist Attacks on U.S. - How can you help?
> Donate cash, emergency relief information
> http://dailynews.yahoo.com/fc/US/Emergency_Information/
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
> For additional commands, email: cocoon-dev-help@xml.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org
Re: AW: ensure uniform xdocs/*.xml
Posted by Davanum Srinivas <di...@yahoo.com>.
Sorry....I need to change my vote.
For the XML Declaration:
> > <?xml version="1.0" encoding="UTF-8"?>
For the DTD:
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
> > > "dtd/document-v10.dtd">
Thanks,
dims
--- Davanum Srinivas <di...@yahoo.com> wrote:
> +1 for the first one.
> -- dims
>
> --- Carsten Ziegeler <cz...@sundn.de> 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.
> >
> > Carsten
> >
> > > thanks, David Crossley
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
> > > For additional commands, email: cocoon-dev-help@xml.apache.org
> > >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
> > For additional commands, email: cocoon-dev-help@xml.apache.org
> >
>
>
> =====
> Davanum Srinivas, JNI-FAQ Manager
> http://www.jGuru.com/faq/JNI
>
> __________________________________________________
> Terrorist Attacks on U.S. - How can you help?
> Donate cash, emergency relief information
> http://dailynews.yahoo.com/fc/US/Emergency_Information/
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
> For additional commands, email: cocoon-dev-help@xml.apache.org
>
=====
Davanum Srinivas, JNI-FAQ Manager
http://www.jGuru.com/faq/JNI
__________________________________________________
Terrorist Attacks on U.S. - How can you help?
Donate cash, emergency relief information
http://dailynews.yahoo.com/fc/US/Emergency_Information/
---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org
Re: AW: ensure uniform xdocs/*.xml
Posted by Davanum Srinivas <di...@yahoo.com>.
+1 for the first one.
-- dims
--- Carsten Ziegeler <cz...@sundn.de> 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.
>
> Carsten
>
> > thanks, David Crossley
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
> > For additional commands, email: cocoon-dev-help@xml.apache.org
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
> For additional commands, email: cocoon-dev-help@xml.apache.org
>
=====
Davanum Srinivas, JNI-FAQ Manager
http://www.jGuru.com/faq/JNI
__________________________________________________
Terrorist Attacks on U.S. - How can you help?
Donate cash, emergency relief information
http://dailynews.yahoo.com/fc/US/Emergency_Information/
---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org
AW: ensure uniform xdocs/*.xml
Posted by Carsten Ziegeler <cz...@sundn.de>.
> 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.
Carsten
> thanks, David Crossley
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
> For additional commands, email: cocoon-dev-help@xml.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org