 <!-- @BRIEF : root element of a description of a software package --> 
 <!-- It's the root element of a description of a software package, in Perl
   Package Distribution (PPD) format which is an XML application. -->
 <!-- HISTORY : v0.1 - Initial release -->
 <!-- SEE ALSO : OSD Specification http://www.microsoft.com/standards/osd/ -->
 <!ELEMENT SOFTPKG   (ABSTRACT | AUTHOR | IMPLEMENTATION | LICENSE | TITLE)*>
 <!-- Name of the package (e.g. ``Foobar''). -->
 <!ATTLIST SOFTPKG   NAME    CDATA #REQUIRED>
 <!-- Version number of the package, in comma-delimited format (e.g. ``1,0,0,0'').  -->
 <!ATTLIST SOFTPKG   VERSION CDATA #IMPLIED>

 <!-- @BRIEF : state the title of the Perl Package -->
 <!-- Used to state the title of the Perl Package. Only one instance should be present. -->
 <!ELEMENT TITLE     (#PCDATA)>

 <!-- Used to provide a short description outlining the nature and purpose of
  the Perl Package. Only one instance should be present. -->
 <!ELEMENT ABSTRACT  (#PCDATA)>

 <!-- Used to provide information about the author(s) of the Perl Package.
  Multiple instances are valid. -->
 <!ELEMENT AUTHOR    (#PCDATA)>

 <!-- Indicating the location of the appropriate license agreement or copyright
  notice for the Perl Package. Only one instance should be present. -->
 <!ELEMENT LICENSE   EMPTY>
 <!-- Required attribute. A reference to the location of the license agreement
  or copyright notice for this package. -->
 <!ATTLIST LICENSE   HREF     CDATA #REQUIRED>

 <!-- @BRIEF : describe a particular implementation of the Perl Package --> 
 <!-- Used to describe a particular implementation of the Perl Package. Multiple
  instances are valid, and should be used to describe different implementations/ports
  for different operating systems or architectures. -->
 <!ELEMENT IMPLEMENTATION    (CODEBASE | DEPENDENCY | LANGUAGE | OS |
                              OSVERSION | PERLCORE | PROCESSOR | INSTALL |
                              UNINSTALL )*  >

 <!-- Indicating a location where an archive of the Perl Package can be retrieved.
  Multiple instances are valid, and can be used to indicate multiple possible
  locations where the same version of the Perl Package can be retrieved. -->
 <!ELEMENT CODEBASE  EMPTY>
 <!-- ??? -->
 <!ATTLIST CODEBASE  FILENAME CDATA #IMPLIED>
 <!-- A reference to the location of the Perl Package distribution. -->
 <!ATTLIST CODEBASE  HREF     CDATA #REQUIRED>

 <!-- Used to indicate a dependency this Perl Package has on another Perl Package.
  Multiple instances are valid. -->
 <!ELEMENT DEPENDENCY EMPTY>
 <!-- Version number of the dependency, in comma-delimited format (e.g. ``1,0,0,0''). -->
 <!ATTLIST DEPENDENCY VERSION CDATA #IMPLIED>
 <!-- Name of the package that this implementation is dependant upon. -->
 <!ATTLIST DEPENDENCY NAME CDATA #REQUIRED>

 <!-- Used to specify the language used within the given implementation of the
  Perl Package. Only one instance should be present. -->
 <!ELEMENT LANGUAGE  EMPTY>
 <!ATTLIST LANGUAGE  VALUE CDATA #REQUIRED>

 <!-- @BRIEF : the operating system required for this implementation --> 
 <!-- Used to outline the operating system required for this implementation of
  the Perl Package. Multiple instances are valid. Valid values can be taken
  from the OSD Specification and it's OS element. -->
 <!ELEMENT OS        EMPTY>
 <!-- The name of the operating system required for this implementation of the
  Perl Package. This value should be obtained from Config.pm as 'osname'. -->
 <!ATTLIST OS        VALUE CDATA #REQUIRED>

 <!-- @BRIEF : the required version of the operating system --> 
 <!-- Used to outline the required version of the operating system required for
  this implementation of the Perl Package. Only one instance should be present. -->
 <!ELEMENT OSVERSION EMPTY>
 <!-- The version of the operating system required for installation of this
  implementation of the package, in a comma-delimited format (e.g. ``3,1,0,0''). -->
 <!ATTLIST OSVERSION VALUE CDATA #REQUIRED>

 <!-- @BRIEF : the minimum version of the Perl core distribution --> 
 <!-- Used to specify the minimum version of the Perl core distribution that
  this Perl Package is to be used with. Only one instance should be present. -->
 <!ELEMENT PERLCORE  EMPTY>
 <!-- Version of the Perl core that is required for this implementation of the
  Perl Package. -->
 <!ATTLIST PERLCORE  VERSION CDATA #REQUIRED>

 <!-- Outlining the cpu required for this implementation of the Perl Package.
  Only one instance should be present. -->
 <!ELEMENT PROCESSOR EMPTY>
 <!-- CPU required for the installation of this implementation of the Perl Package.
  The following values are all valid according to the OSD Specification:
   x86 alpha mips sparc 680x0 -->
 <!ATTLIST PROCESSOR VALUE CDATA #REQUIRED>

 <!-- @BRIEF : provide either a reference to an installation script -->
 <!-- Used to provide either a reference to an installation script or a series
  of commands which can be used to install the Perl Package once it has been
  retrieved. If the EXEC attribute is not specified, the value is assumed to be
  one or more commands, separated by `;;'. Each such command will be executed
  by the Perl `system()'function. Only one instance should be present. -->
 <!ELEMENT INSTALL   (#PCDATA)>
 <!-- Reference to an external script which should be retrieved and run as part of
  the installation process. Both filenames and URLs should be considered valid. -->
 <!ATTLIST INSTALL   HREF  CDATA #IMPLIED>
 <!-- Name of interpreter/shell used to execute the installation script. If the
  value of EXEC is `PPM_PERL', the copy of Perl that is executing PPM itself ($^X)
  is used to execute the install script. -->
 <!ATTLIST INSTALL   EXEC  CDATA #IMPLIED>

 <!-- @BRIEF : provide either a reference to an uninstallation script -->
 <!-- Used to provide either a reference to an uninstallation script or a raw
  Perl script which can be used to uninstall the Perl Package at a later point.
  Only one instance should be present. -->
 <!ELEMENT UNINSTALL (#PCDATA)>
 <!-- Reference to an external script which should be retrieved and run as part
  of the removal process. Both filenames and URLs should be considered valid. -->
 <!ATTLIST UNINSTALL HREF  CDATA #IMPLIED>
 <!-- Name of interpreter/shell used to execute the uninstallation script. If the
  value of EXEC is `PPM_PERL', the copy of Perl that is executing PPM itself ($^X)
  is used to execute the install script. -->
 <!ATTLIST UNINSTALL EXEC  CDATA #IMPLIED>


