Phase1 DTD Distribution

The files contained in this package include the XML DTD and associated
files used by the current version of the Gemini Phase 1 Tool to
generate Gemini Phase 1 proposals.  

What is here:
  README_DISTRIBUTION - this file.

  CHANGES - this file is a history of changes to the AstronomyPhase1 DTD.

  GEMINI_CHANGES - this file is a history of the Gemini phase1 extension.

  AstronomyPhase1.dtd - this is the XML Document Type Declaration (DTD) 
that describes a generic Phase 1 proposal.  It allows multiple observatories
to add their own information to a proposal while sharing common information.

  AstronomyPhase1Data.dtd - this is the data file that supports the
common part of the Phase 1 proposal.  Included is the set of keywords and
keyword categories.  A list of sites/institutions is also included.  More
sites are needed.

  Gemini.dtd - This is a DTD for the Gemini 8m Telescope extensions and
constraints.  It uses the information in the AstronomyPhase1.dtd.

  target.mod - This is an external DTD describing the possible coordinate
systems that can be used to specify target positions.  Note that not all
of these are allowed in Gemini proposals.  Other observatories wish to
use these expanded coordinate systems.

  GeminiData.xml - this is an XML file of data that supports the creation
of Gemini Proposals.  It contains an example of a Gemini resource list, 
information about the scheduling period, and information that can be used by
authoring tools.  For a given semester, this file changes, so be
sure and look at the GeminiData.xml file included with PIT for 
the semester in question.  To locate the GeminiData.xml file in
pit, user jar (or unzip) to unpack the resources.jar file.
(jar -xvf resources.jar - just like tar).

  geminiDemon.xml - this is a fully developed, valid, well-formed Gemini
proposal.  It obeys the Gemini DTD and Astronomyphase1 DTD and all 
external validity constraints.  It is compatible with the DTDs
in this package.

  XmlTester.java - This is a small test file that can be compiled and
used with the Apache Xerces Java package to test your file 
against the DTDs.
  Type: XmlTester [dom|domn] filename
  Argument dom uses a validating parser (needs DTDs).
  Argument domn uses a non-validating parser.

What will change:
  The GeminiData.xml file will change and will continue to change
for each observing semester as new resources appear and old ones 
go away.  The AstronomyPhase1Data file will also change as new sites
are added.  The list of keywords and categories is stable.

  The Gemini validity constraints are fixed for the known future.

What Gemini Expects:

Gemini expects a proposal to include a Gemini proposal in XML format as
described by the DTDs and validity constraints and any attachments 
in the Gemini-specified acceptable formats.

Documents
  Two PDF documents are included.  One describes the general Astronomy
Phase 1 DTD.  The other specifies what Gemini expects in more detail.


