Provided by: epm_4.2-2_i386 bug

NAME

       epm.list - epm list file format.

DESCRIPTION

       Each  EPM  product has an associated list file that describes the files
       to include with the product. Comment lines begin with the "#" character
       and  are  ignored.  All other non-blank lines must begin with a letter,
       dollar sign ("$"), or the percent sign ("%") as follows:

       $name=value
            Sets the named variable to value. Note: Variables set in the  list
            file  are overridden by variables specified on the command-line or
            in the current environment.

       %arch all
            Uses   following   files   and   directives   on   all   processor
            architectures.

       %arch architecture [... architecture]
            Uses  following  files  and  directives  on  the  named  processor
            architectures.

       %arch !architecture [... architecture]
            Uses following files and directives on all but the named processor
            architectures.

       %copyright copyright notice
            Sets the copyright notice for the file.

       %description description text
            Adds  a  line  of  descriptive  text to the distribution. Multiple
            lines are supported.

       %format format [... format]
            Uses following files  and  directives  only  if  the  distribution
            format is the same as format.

       %format !format [... format]
            Uses  following  files  and  directives  only  if the distribution
            format is not the same as format.

       %if variable [... variable]

       %if !variable [... variable]

       %ifdef variable [... variable]

       %ifdef !variable [... variable]

       %elseif variable [... variable]

       %elseif !variable [... variable]

       %elseifdef variable [... variable]

       %elseifdef !variable [... variable]

       %else

       %endif
            Conditionally includes lines in  the  list  file.  The  %if  lines
            include  the  lines  that  follow if the named variables are (not)
            defined with a value. The %ifdef  lines  include  the  lines  that
            follow  if  the  named variables are (not) defined with any value.
            These conditional lines cannot be nested.

       %include filename
            Includes files listed in filename.

       %incompat product

       %incompat filename
            Indicates that this product is incompatible with the named product
            or file.

       %install script or program
            Specifies  a  script  or  program  to  be  run after all files are
            installed.   (This  has  been  obsoleted   by   the   %postinstall
            directive)

       %license license file
            Specifies the file to display as the software license.

       %literal(section) line

       %literal(section) <file

       %literal(section) <<string
            Specifies  format-specific  literal  data for packaging. Currently
            only supported for RPM and PKG packages.

       %packager name of packager
            Specifies the name of the packager.

       %patch script or program
            Specifies a script or program  to  be  run  after  all  files  are
            patched.  (This has been obsoleted by the %postpatch directive)

       %postinstall script or program

       %postinstall <scriptfile

       %postinstall <<string
            Specifies  a  script  or  program  to  be  run after all files are
            installed.

       %postpatch script or program

       %postpatch <scriptfile

       %postpatch <<string
            Specifies a script or program  to  be  run  after  all  files  are
            patched.

       %postremove script or program

       %postremove <scriptfile

       %postremove <<string
            Specifies a script or program to be run after removing files.

       %preinstall script or program

       %preinstall <scriptfile

       %preinstall <<string
            Specifies  a  script  or  program  to  be run before all files are
            installed.

       %prepatch script or program

       %prepatch <scriptfile

       %prepatch <<string
            Specifies a script or program to  be  run  before  all  files  are
            patched.

       %preremove script or program

       %preremove <scriptfile

       %preremove <<string
            Specifies a script or program to be run before removing files.

       %product product name
            Specifies the product name.

       %readme readme file
            Specifies a README file to be included in the distribution.

       %remove script or program
            Specifies  a  script  or  program to be run before removing files.
            (This has been obsoleted by the %preremove directive)

       %release number
            Specifies the release or build number of a  product  (defaults  to
            0).

       %replaces product
            Indicates that this product replaces the named product.

       %requires product

       %requires filename
            Indicates that this product requires the named product or file.

       %subpackage

       %subpackage name
            Selects  the  named  subpackage;  if no name is given, selects the
            main (parent) package.

       %vendor vendor or author name
            Specifies the vendor or author of the product.

       %version version number
            Specifies the version number of the product.

       %system system[-release] [... system[-release]]
            Specifies that the following files should only  be  used  for  the
            specified operating systems and releases.

       %system !system[-release] [... system[-release]]
            Specifies  that  the  following  files  should not be used for the
            specified operating systems and releases.

       %system all
            Specifies that the following files are applicable to all operating
            systems.

       c mode user group destination source

       C mode user group destination source
            Specifies  a  configuration file for installation. The second form
            specifies that the file has  changed  or  is  new  and  should  be
            included  as part of a patch. Configuration files are installed as
            "destination.N" if the destination already exists.

       d mode user group destination -

       D mode user group destination -
            Specifies a  directory  should  be  created  when  installing  the
            software.  The second form specifies that the directory is new and
            should be included as part of a patch.

       f mode user group destination source [nostrip()]

       F mode user group destination source [nostrip()]
            Specifies a file for installation. The second form specifies  that
            the file has changed or is new and should be included as part of a
            patch. If the "nostrip()" option is included, the file will not be
            stripped before the installation is created.

       f mode user group destination source/pattern [nostrip()]

       F mode user group destination source/pattern [nostrip()]
            Specifies  one or more files for installation using shell wildcard
            patterns. The second form specifies that the files have changed or
            are  new  and  should  be  included  as  part  of  a patch. If the
            "nostrip()" option is included, the  file  will  not  be  stripped
            before the installation is created.

       i mode user group service-name source ["options"]

       I mode user group service-name source ["options"]
            Specifies  an  initialization  script for installation. The second
            form specifies that the file has changed or is new and  should  be
            included  as part of a patch. Initialization scripts are stored in
            /etc/software/init.d and are linked  to  the  appropriate  system-
            specific directories for run levels 0, 2, 3, and 5. Initialization
            scripts must accept at least the  start  and  stop  commands.  The
            optional  options  following the source filename can be any of the
            following:

            order(string)
                 Specifies the relative startup order compared to the required
                 and  used  system  functions. Supported values include First,
                 Early, None, Late, and Last (OSX only).

            provides(name(s))
                 Specifies names of system functions that are provided by this
                 startup item (OSX only).

            requires(name(s))
                 Specifies names of system functions that are required by this
                 startup item (OSX only).

            runlevel(levels)
                 Specifies the run levels to use.

            start(number)
                 Specifies the starting sequence number from 00 to 99.

            stop(number)
                 Specifies the ending sequence number from 00 to 99.

            uses(name(s))
                 Specifies names of system functions that  are  used  by  this
                 startup item (OSX only).

       l mode user group destination source

       L mode user group destination source
            Specifies  a  symbolic  link  in the installation. The second form
            specifies that the link has  changed  or  is  new  and  should  be
            included as part of a patch.

       R mode user group destination
            Specifies  that the file is to be removed upon patching.  The user
            and group fields are ignored.  The mode  field  is  only  used  to
            determine  if a check should be made for a previous version of the
            file.

LIST VARIABLES

       EPM maintains a list of variables and their values which can be used to
       substitute  values  in the list file. These variables are imported from
       the current environment and taken from the command-line and  list  file
       as  provided.  Substitutions occur when the variable name is referenced
       with the dollar sign ($):

           %postinstall <<EOF
           echo What is your name:
           read $$name
           Your name is $$name
           EOF

           f 0555 root sys ${bindir}/foo foo
           f 0555 root sys $datadir/foo/foo.dat foo.dat

       Variable names can be surrounded by curley brackets (${name}) or  alone
       ($name);  without  brackets  the  name is terminated by the first slash
       (/), dash (-), or whitespace. The dollar sign can be inserted using $$.

SEE ALSO

       epm(1) - create software packages
       epminstall(1) - add a directory, file, or symlink to a list file
       mkepmlist(1) - make an epm list file from a directory

COPYRIGHT

       Copyright 1999-2010 by Easy Software Products, All Rights Reserved.

       This program 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, or  (at  your  option)  any
       later version.

       This  program  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.