Date: Tue Jul 22 12:14:11 2003

# Perl Package Distribution

## Elements index.

ABSTRACT
AUTHOR
CODEBASE
DEPENDENCY
IMPLEMENTATION
INSTALL
LANGUAGE
LICENSE
OS
OSVERSION
PERLCORE
PROCESSOR
SOFTPKG (root)
TITLE
UNINSTALL

## Entities index.

## Notations index.

## Examples list.

## Element tree.

- SOFTPKG
  - IMPLEMENTATION
    - INSTALL
    - CODEBASE
    - OSVERSION
    - LANGUAGE
    - UNINSTALL
    - DEPENDENCY
    - OS
    - PROCESSOR
    - PERLCORE
  - LICENSE
  - ABSTRACT
  - TITLE
  - AUTHOR

### Prolog

<!DOCTYPE SOFTPKG SYSTEM 'ppd.dtd' >

The DTD for PPD documents is available from the ActiveState website and the latest version can be found at http://www.ActiveState.com/PPM/DTD/ppd.dtd

- ### SOFTPKG

  <!ELEMENT SOFTPKG (ABSTRACT|AUTHOR|IMPLEMENTATION|LICENSE|TITLE)* >
  <!ATTLIST SOFTPKG NAME CDATA #REQUIRED >
  <!ATTLIST SOFTPKG VERSION CDATA #IMPLIED >

  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/

  - NAME :

    Name of the package (e.g. ``Foobar'').

  - VERSION :

    Version number of the package, in comma-delimited format (e.g. ``1,0,0,0'').

- ### TITLE

  <!ELEMENT TITLE (#PCDATA) >

  Used to state the title of the Perl Package. Only one instance should be present.

- ### ABSTRACT

  <!ELEMENT ABSTRACT (#PCDATA) >

  Used to provide a short description outlining the nature and purpose of the Perl Package. Only one instance should be present.

- ### AUTHOR

  <!ELEMENT AUTHOR (#PCDATA) >

  Used to provide information about the author(s) of the Perl Package. Multiple instances are valid.

- ### LICENSE

  <!ELEMENT LICENSE EMPTY >
  <!ATTLIST LICENSE HREF CDATA #REQUIRED >

  Indicating the location of the appropriate license agreement or copyright notice for the Perl Package. Only one instance should be present.

  - HREF :

    Required attribute. A reference to the location of the license agreement or copyright notice for this package.

- ### IMPLEMENTATION

  <!ELEMENT IMPLEMENTATION (CODEBASE|DEPENDENCY|LANGUAGE|OS|OSVERSION|PERLCORE|PROCESSOR|INSTALL|UNINSTALL)* >

  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.

- ### CODEBASE

  <!ELEMENT CODEBASE EMPTY >
  <!ATTLIST CODEBASE FILENAME CDATA #IMPLIED >
  <!ATTLIST CODEBASE HREF CDATA #REQUIRED >

  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.

  - FILENAME :

    ???

  - HREF :

    A reference to the location of the Perl Package distribution.

- ### DEPENDENCY

  <!ELEMENT DEPENDENCY EMPTY >
  <!ATTLIST DEPENDENCY VERSION CDATA #IMPLIED >
  <!ATTLIST DEPENDENCY NAME CDATA #REQUIRED >

  Used to indicate a dependency this Perl Package has on another Perl Package. Multiple instances are valid.

  - VERSION :

    Version number of the dependency, in comma-delimited format (e.g. ``1,0,0,0'').

  - NAME :

    Name of the package that this implementation is dependant upon.

- ### LANGUAGE

  <!ELEMENT LANGUAGE EMPTY >
  <!ATTLIST LANGUAGE VALUE CDATA #REQUIRED >

  Used to specify the language used within the given implementation of the Perl Package. Only one instance should be present.

- ### OS

  <!ELEMENT OS EMPTY >
  <!ATTLIST OS VALUE CDATA #REQUIRED >

  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.

  - VALUE :

    The name of the operating system required for this implementation of the Perl Package. This value should be obtained from Config.pm as 'osname'.

- ### OSVERSION

  <!ELEMENT OSVERSION EMPTY >
  <!ATTLIST OSVERSION VALUE CDATA #REQUIRED >

  Used to outline the required version of the operating system required for this implementation of the Perl Package. Only one instance should be present.

  - VALUE :

    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'').

- ### PERLCORE

  <!ELEMENT PERLCORE EMPTY >
  <!ATTLIST PERLCORE VERSION CDATA #REQUIRED >

  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.

  - VERSION :

    Version of the Perl core that is required for this implementation of the Perl Package.

- ### PROCESSOR

  <!ELEMENT PROCESSOR EMPTY >
  <!ATTLIST PROCESSOR VALUE CDATA #REQUIRED >

  Outlining the cpu required for this implementation of the Perl Package. Only one instance should be present.

  - VALUE :

    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

- ### INSTALL

  <!ELEMENT INSTALL (#PCDATA) >
  <!ATTLIST INSTALL HREF CDATA #IMPLIED >
  <!ATTLIST INSTALL EXEC CDATA #IMPLIED >

  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.

  - HREF :

    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.

  - EXEC :

    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.

- ### UNINSTALL

  <!ELEMENT UNINSTALL (#PCDATA) >
  <!ATTLIST UNINSTALL HREF CDATA #IMPLIED >
  <!ATTLIST UNINSTALL EXEC CDATA #IMPLIED >

  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.

  - HREF :

    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.

  - EXEC :

    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.

Generated by dtd2html