Perl Package Distribution

<!ELEMENT TITLE (#PCDATA) >

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

<!ELEMENT ABSTRACT (#PCDATA) >

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

<!ELEMENT AUTHOR (#PCDATA) >

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

<!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.

<!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.

<!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.

<!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.

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

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

<!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.

<!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

<!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.

<!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.