#       '$RCSfile: README,v $'
#       Copyright: 1997-2002 Regents of the University of California,
#                            University of New Mexico, and
#                            Arizona State University
#        Sponsors: National Center for Ecological Analysis and Synthesis and
#                  Partnership for Interdisciplinary Studies of Coastal Oceans,
#                     University of California Santa Barbara
#                  Long-Term Ecological Research Network Office,
#                     University of New Mexico
#                  Center for Environmental Studies, Arizona State University
#   Other funding: National Science Foundation (see README for details)
#                  The David and Lucile Packard Foundation
#     For Details: http://knb.ecoinformatics.org/
#
#        '$Author: jones $'
#          '$Date: 2002-12-06 23:15:18 $'
#      '$Revision: 1.29 $'
# 
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

EML: Ecological Metadata Language
---------------------------------

Version: 2.0.0

Feedback and bugs to: eml-dev@ecoinformatics.org
                      http://bugzilla.ecoinformatics.org

Contributors: Matt Jones (jones@nceas.ucsb.edu)
              Chad Berkley (berkley@nceas.ucsb.edu)
              Jivka Bojilova (bojilova@nceas.ucsb.edu)
              Dan Higgins (higgins@nceas.ucsb.edu)
              Chris Jones (cjones@lifesci.ucsb.edu)
              Corinna Gries (corinna@asu.edu)
              Peter McCartney (peter.mccartney@asu.edu)
              James Brunt (jbrunt@lternet.edu)
              David Blankman (dblankman@lternet.edu)
              Owen Eddins (oeddins@lternet.edu)
              Mark Schildhauer (schild@nceas.ucsb.edu)
              John Harris (harris@nceas.ucsb.edu)
              Matthew Brooke (brooke@nceas.ucsb.edu)
              Scott Chapal (scott.chapal@jonesctr.org)
              Tim Bergsma (tbergsma@kbs.msu.edu)
              Ken Ramsey (kramsey@jornada.nmsu.edu)

Web site: http://knb.ecoinformatics.org/software/eml

The Ecological Metadata Language consists of a number of modules that define
an XML markup syntax for ecologically relevant metadata.  It was originally
based on work done by the ESA Committee on the Future of Long-Term
Ecological Data (http://esa.sdsc.edu/FLED/FLED.html) and on a related paper
on ecological metadata by Michener et al. (see Michener, William K., et al., 
1997. Ecological Applications, "Nongeospatial metadata for the ecological 
sciences" Vol 7(1). pp. 330-342.).  Version 1.4 follows that paper closely in
its content implementation, but Version 2 has been modified substantially after
experience using the specification and from feedback from the ecological 
community.

This release represents the consensus view of a large number of knowledgeable
scientists and data managers on what metadata are relevant to ecological
data and how best to represent it.  Of course, many might differ in opinion 
about specific decisions made during the development of EML; we would like to
encourage users to faithfully use the specification in the spirit of 
community building.  It is better if we all use a metadata language that covers
most of our needs than to modify it and use one that is perfect but not shared
with anybody.

It is notable that some of the rules regarding EML that are important are
expressed only in the EML specification, not in the XML Schema files.  This is
because XML Schema was not able to express some of the constraints that we
felt were important to creating a coherent metadata document, particularly
with respect to identifiers and references to identifiers.  Thus, we have
included a new EML Validity Parser.  It checks both EML rules and the schema
rules to be sure an XML document is a valid EML document.  It is included
with the release, and provided as an online service. See docs/index.html.

DOCUMENTATION
-------------
Please see the docs/index.html directory for a a list of the relevant
documents pertaining to EML.  In particular, this release ships with a full
version of the EML Specification, which is the definitive document explaining
the rules associated with the Ecological Metadata Language.

FILES
-----
The files in this distribution are a part of the final release of EML 2.0.0.
Note that there have been 9 beta releases and three prior release candidates
prior to this during which substantial/philosophical changes were introduced.

The files in this directory include a "docs" directory that contains the
EML Specification and all documentation for the modules, and an XML Schema
document for each of the modules that make up EML.  Also included is a schema
for supporting documentation, and an instance document defining standard
attribute units for EML. The "lib/sample/eml-sample.xml" file is a sample
document illustrating the use of EML. The "test" directory contains a number
of sample instance documents used for testing the schemas, and an application
for checking document validity under JUnit (see http://junit.org).

This release of EML can be retrieved from CVS using the 
tag "RELEASE_EML_2_0_0".  Previous versions of EML (such as 1.4) 
are available from this repository using the appropriate release tag 
(i.e. RELEASE_EML_1_4).

HIGHLIGHTS IN THIS RELEASE
--------------------------
1) Modified eml-attribute measurementScale to include a new "datetime" scale
   that specifically addresses issues with calendar date and time values

KNOWN ISSUES (see also http://bugzilla.ecoinformatics.org/)
-----------------------------------------------------------
1) Complete work on the XSLT stylesheets.  Need to convert stylesheets
   to the new structure (they currently work with the BETA6 release)
   (bug 249).

BUGS FIXED AND NEW FEATURES (see also http://bugzilla.ecoinformatics.org/)
--------------------------------------------------------------------------
2.0.0 Changes- (numbers refer to the corresponding Bugzilla bug)
670: DateTimeDomain id/reference validation
924: make date time its own measurement scale
661: spell check eml-attribute.xsd and synchronize with unitDi
918: example tag in eml:documentation

2.0.0rc3 Changes- (numbers refer to the corresponding Bugzilla bug)
471: eml spec overview document     
624: eml-methods/methodsType needs clarification on choice/seq...     
627: links broken in EML FAQ     
629: unit conversion coefficients need checking     
637: attributeDomain should be required     
638: request for id/ref in attributeDomain     
654: scope of the unit element     
655: need better model for numeric domains for attributes     
625: Cardinality regarding eml-methods should be corrected in ...     
626: ProcedureStepType schema needs revision to protect sequen...     
628: eml-physical has lit: rather than cit: references     
632: broken link in faq
634: Documentation of reference elements in the schemas
656: physical should be repeatable

RC2 Changes- (numbers refer to the corresponding Bugzilla bug)
568: accommodate of stateful connection information   
586: resolve validation problem with missing keys     
588: Remove lineage tags in documentation stylesheets     
589: eml-coverage: convert element references to types     
592: fix validation error with xs:anyType
594: change cardinality for designDescription and studyAreaDes...     
596: Proposal: make attribute optional in OtherEntityType.     
597: In eml-dataTable caseSensitive and orientation are modele...     
598: literature namespace references are inconsistent     
599: storageType is repeatable in eml-attribute     
600: eml-storedProcedure - problems & proposal     
601: element names in spatial modules do not follow guidelines     
602: eml-physical fixed textFormat to allow mixed fixed/delimited
608: release preparation tasks for EML2.0.0rc2
622: redundancy in eml-physical/binaryRaster

RC1 Changes- (numbers refer to the corresponding Bugzilla bug)
471: created an EML specification overview document
495: created FAQ for EML
588: removed lineage tags from documentation stylesheet
484: eml-attribute changes to unit and attributeDomain
579: fixed eml-docbook validation problems
491: eml-coverage changed to correctly import types and to fix
     singleDateTime model
485: eml-physical changed to fix fixed ascii descriptors and distribution
477: complexTypes imports changed to consistent model
486: fixed spelling errors in eml-constraint
492: eml-literature changed for EndNote consistency
496: copyright updated throughout
557: textual elements changed to use docbook subset define in eml-text.xsd
563: changed id types from xs:ID to xs:string to allow numeric ids
482: eml-dataset changed to include method element
489: eml-protocol completely revised based on feedback, eml-method.xsd created
544: eml-attribute storageType and attributeDomain documentation clarified
556: format of eml namespaces changed to include ecoinformatics.org
539: added additionalInfo and alternateIdentifier to eml-dataTable.xsd
568: redesigned DistributionType to allow richer connection descriptions
566: changed imports in eml-resource to import resource types not elements
567: created eml sample documents and XML validation framework using ant/junit 

Beta9 Fixes-
1) Changed packaging concept to use internal id and references instead
   of triples
2) Review and revised all modules according to agreed upon changes from 
   the April, 2002 EML meeting at Sevilleta Field Station

Beta 8 Fixes-
1) Fixed illegal declaration of type and extension in eml-entity
2) Updated all PNG image files

Beta 7 Fixes-
1) Added a 'style' subdirectory with a style sheet for most modules
   to translate the metadata to HTML
2) Changed names of coverage elements to be human readable
3) Updated the namespaces to reflect the current version number of EML
4) Added an eml-data module for the in-lining of data.
5) Added the eml module for creating packages all in one file.  It is a single
   node with a model of ANY so any of the eml modules can be put into it.
6) Numerous bug fixes (see bugzilla.ecoinformatics.org)

Legalese
--------
This software is copyrighted (1997-2002) by The Regents of the University
of California, University of New Mexico, and Arizona State University and
licensed under the GNU GPL; see the 'LICENSE' file for details.

This material is based upon work supported by the National Science Foundation
under Grant No. DEB-9980154, DBI-9904777, DEB-0072909, DBI-9983132,
and DEB-9634135.  Any opinions, findings and conclusions or recommendations
expressed in this material are those of the author(s) and do not necessarily
reflect the views of the National Science Foundation (NSF).

This product includes software developed by the Apache Software 
Foundation (http://www.apache.org/). See the LICENSE file in lib/apache
for details.

The source code, object code, and documentation in the com.oreilly.servlet 
package is copyright and owned by Jason Hunter. See the cos-license.html file
for details of the license.  Licensor retains title to and ownership of the 
Software and all enhancements, modifications, and updates to the Software.

This product includes software developed by the JDOM Project 
(http://www.jdom.org/). See jdom-LICENSE.txt for details.

