Return to piml.dtd CVS log

Up to [LON-CAPA] / loncom / build

document type definition for piml; post installation markup language

<!--
       Post Installation Markup Language version 1.0.

       Date: January 24, 2002
       Author: Scott Harrison

       Post Installation Markup Language works to perform
       'intelligent' modifications of existing files on
       a software system.  This allows for the reconfiguring
       of existing configuration files without having the
       overlap of files between software packages.  PIML
       also allows you to have file permission/ownership
       specifications different than that specified by the
       original software package.

       For instance, Apache web server configuration files
       are a popular target for many different software applications.
       A preferred approach is to simply append an 'Include ...'
       line to the Apache web server configuration files.

       Post Installation Markup Language is meant to be
       a natural wrapper to target installations generated
       by LPML (Linux Packaging Markup Language).

       Usages of Post Installation Markup Language are:
       * immediately after installation with LPML
       * generating '%post' syntax for RPMs
       * generating post-installation syntax for Debian packages.

       Dependency checking is supported as a poor man's probing....
       There is no point in reconfiguring a file that isn't installed,
       or is missing a system component for successful operation.

       Another neat use of PIML is to allow for invocation of various
       processes after installation.
-->
<!--

Copyright Michigan State University Board of Trustees

This file is part of the LearningOnline Network with CAPA (LON-CAPA).

LON-CAPA 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.

LON-CAPA 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 LON-CAPA; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

/home/httpd/html/adm/gpl.txt

http://www.lon-capa.org/

-->

<!ENTITY % piml.Version
        "-//TUX//DTD piml 1.0 Final//EN"

        -- Typical usage:

            <!DOCTYPE piml PUBLIC "-//TUX//DTD PIML 1.0 Final//EN">
            <piml>

            </piml>
        --
        >

<!ELEMENT categoryname (#PCDATA)>
<!ELEMENT targetroot (#PCDATA)>
<!ELEMENT sourceroot (#PCDATA)>

<!ELEMENT target (#PCDATA)>
<!ATTLIST target
    dist CDATA #REQUIRED
    >
<!ELEMENT piml (specialnotices|files|categories)+>
<!ELEMENT specialnotices specialnotice+>
<!ELEMENT categories category+>
<!ELEMENT files (file)+>
<!ELEMENT dependencies (#PCDATA)>
<!ELEMENT note (#PCDATA)>

<!ELEMENT specialnotice (#PCDATA)>
<!ELEMENT category (chmod,chown,abbreviation)>
<!ATTLIST category
    type CDATA #REQUIRED
    name CDATA #REQUIRED
    >
<!ELEMENT chown (#PCDATA)>
<!ATTLIST chown
    dist CDATA #REQUIRED
    >
<!ELEMENT chmod (#PCDATA)>
<!ATTLIST chmod
    dist CDATA #REQUIRED
    >
<!ELEMENT abbreviation (#PCDATA)>

<!ELEMENT file (target,categoryname?,description?,
                note?,status?,dependencies?,perlscript)>
<!ELEMENT perlscript (#PCDATA)>