NAME

       icmstart.rc - The icmstart(1) resource file

DESCRIPTION

       The icmstart.rc file specifies the files that are installed by icmstart(1).

       By   default   icmstart.rc   is   found   in   /etc/icmake/icmstart.rc,   but  if  a  file
       $HOME/.icmake/icmstart.rc  is  found  then  the  latter  file  is  used  by   icmstart(1).
       $HOME/.icmake/icmstart.rc  in  turn  is  overruled by specifying a -c option when invoking
       icmstart(1).

       The default resource  file  contains  the  following  specifications,  preparing  for  the
       construction of a C++ program using icmbuild(1):

           CLASSES
           icmconf
           P main.cc
           P main.ih
           P usage.cc
           P version.cc
           P ? scanner
           P ? parser

       The icmstart.rc file may contain:

       o      empty lines, which are ignored;

       o      lines beginning with a hash-character (#), also ignored;

       o      an optional installation mode followed by a source-destination specification.

INSTALLATION MODE

       An installation mode consists of a combination of:

       o      either  a  P  (don’t install with icmstart xxx library) or an L (don’t install with
              icmstart xxx program);

       o      a D, indicating that the source must also be installed by default, i.e., if neither
              `program’ or `library’ was specified as second argument.

       o      a  b, indicating that the file must not be installed if the -b (basic installation)
              option was specified when calling icmstart.

       o      Following the optional P, L, D, b combination a space delimited optional ?  may  be
              specified. If specified the installation of the file or directory must be confirmed
              by the user.

SOURCE-DESTINATION SPECIFICATIONS

       The following source-destination specifications can be used in an icmstart.rc file:

       o      source
              A plain name must exist in the icmstart’s skeleton directory. It  is  installed  in
              the destination directory `dest’ specified when calling icmstart(1). Example:

                  CLASSES

              skeletondir/CLASSES is installed as dest/CLASSES

       o      pathspec
              If  `pathspec’  does  not  begin  with a slash it must exist in icmstart’s skeleton
              directory.  It is installed as `pathspec’ in the  destination  directory  specified
              when calling icmstart(1). Example:

                  dir/file

              skeletondir/dir/file is installed as dest/dir/file

       o      /pathspec  or  ~/pathspec The ~-character is expanded to the user’s home directory.
              The pathspec’s final element is installed in the  destination  directory  specified
              when calling icmstart(1). Example:

                  ~/.icmake/file

              $HOME/.icmake/file  is  installed as dest/file When the above source specifications
              are followed by a  destination  specification  destspec  (a  file  or  non-absolute
              directory   specification)   then   the   source   specification  is  installed  as
              dest/destspec) below the destination directory specified when calling  icmstart(1).
              Examples:

                  CLASSES CLASSES             # skeletondir/CLASSES is installed as
                                              #   dest/CLASSES
                  dir/file dir/file           # skeletondir/dir/file is installed as
                                              #   dest/dir/file
                  ~/.icmake/file .icmake/file # $HOME/.icmake/file is installed as
                                              #   dest/.icmake/file

              Icmstart  conveerts  the destination specification to a full path specification. If
              this full path specification does not begin with dest’s full path specification  an
              error message is displayed and icmstart ends.

FILES

       The mentioned paths are sugestive only and may be installation dependent:

       o      /usr/share/icmake/icmconf Example of an icmbuild configuration file;

       o      /usr/share/icmake/CLASSES Example of an icmbuild CLASSES file.

       o      /usr/share/icmake/icmstart.rc Default skeleton resource file.

SEE ALSO

       icmake(1), icmbuild(1), icmconf(7), icmstart(1)

BUGS

       None reported

COPYRIGHT

       This  is  free  software,  distributed  under  the terms of the GNU General Public License
       (GPL).

AUTHOR

       Frank B. Brokken (f.b.brokken@rug.nl).