EML

• Bug 2704 has been marked as a duplicate of this bug. ***

• Bug 2705 has been marked as a duplicate of this bug. ***

from INigo and Margaret:
EML uses some parts of DocBook schema (eg. <para> and children). Some of these are generating the parsing errors in XMLSpy 2006+. For example, in eml.xsd, there are these lines inside <para> :
<ulink url="http://dublincore.org/documents/usageguide/">
<citetitle>
The Dublin Core Metadata Initiative
</citetitle>
</ulink>

So it seems that there are 2 choices for the short term:
1. take all the ulink, citetitle, and other offending tags out of eml documentation
2. add these elements in as children of para

We could consider adding these back (and maybe more?) docBook elements later (i.e., 2.1+)

From Chris and Margaret:
With respect to the docbook elements that contribute to this bug in eml-text.xsd, we looked into the status of the DocBook schema. We discovered that as of March 2008, there is a committee draft for DocBook schema v5. It appears to be a complete refactoring of v4 (the dtd), and introduces many backward incompatibilities. Although EML is not terribly dependent on v4, importing this schema is likely to be outside the scope of eml-2.0.2, but might be considered in the future.

current specification http://www.docbook.org/specs/docbook-5.0-spec-cd-03.html
development history http://www.docbook.org/specs/

This is a summary of the fixes reported necessary by Inigo in his email to eml-dev (2008-02-27). Probably this list could be split into multiple bugs. Most schema docs are affected, and many also affect instance docs.

a. <xs:complexType name="TextType"> => add mixed="true"

b. and to the choice of this complexType add minOccurs="0"

c. eml-documentation.xsd:
add elementFormDefault="qualified" to the root-element

1 - : <ulink> unexpected under <para> in eml.xsd and elsewhere--> add element <ulink>, and child tag (<citetitle>) to the <para> element (in eml-text.xsd), following the "docBook" model.

2 - : no more elements under <moduleDocs> --> close element <moduleDocs> before we open <doc:module>s (group was not nested appropriately in eml.xsd)

3 - : further elements required under element <doc:description> in about ALL *.xsd files ---> added <section xmlns=""><para> group following <doc:description> and corresponding closing elements.

4 - : further elements required under element <doc:example> in most of *.xsd files --> added <section xmlns=""><para> group inside <doc:example> and corresponding closing elements.

5 - : empty element <doc:example/> in "methods description" eml-entity.xsd --> entry <doc:example/> deleted

6 - : element <sidebar> not allowed under element <section> in eml-attribute.xsd --> removed <sidebar> and corresponding closing element

7 - : <title> element opened after <para> group, not allowed ---> closed </section>, reopen <section>, then <title> is OK. (so, added </section><section> before <title>)

8 - new soft-complain: namespaces added for "coverage" in eml-dataTable.xsd

9 - : many empty <doc:description/> elements in eml-spatialRaster.xsd ---> Many elements removed or filled with "summary" content

10 - : many empty <doc:description/> elements in eml-spatialReference.xsd ---> Many elements <doc:description> filled with preceeding "<doc:summary>" content

11 - : many empty <doc:description/> elements in eml-spatialVector.xsd ---> Many elements <doc:description/> removed from eml-spatialVector.xsd

These are the changes required to fix bug 2703 (disregard list from previous comment):
1. eml-documentation.xsd: elements moduleName, moduleDescripiton, recommendedUsage, standAlone should be set to form="qualified"
2. eml-text.xsd: add mixed="true" to the definition of txt:TextType
3. eml-text.xsd: the <para> and <section> elements must be optional (minOccurs="0" maxOccurs="unbounded")
4. eml-text.xsd: add a child element to para: <ulink>
5. eml-text.xsd: add a child element to para: <citetitle>
6. eml-text.xsd: change element <sidebar> to <section>

The schema now validates in xmlSpy2007 at the W3C, everywhere.
http://www.w3.org/2001/03/webdata/xsv
For a version of the XSV validator which can be added to the oxygen editor, see:
http://www.oxygenxml.com/doc/ug-standalone/custom-validation.html

small correction to fixes for 2703:
the offending tag <sidebar> appears in the attribute schema, not eml-text.xsd

6. eml-attribute.xsd: change element <sidebar> to <section>

changing status to "fixed"

Original Bugzilla ID was 2703