NAME

       icmstart.rc - The icmstart(1) resource file

DESCRIPTION

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

       A  default  icmstart.rc is found in /etc/icmake/icmstart.rc, but if $HOME/.icmake/icmstart.rc exists 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
           Pb usage.cc
           Pb 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, or b character 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 (using skeletons below
       to refer to icmstart’s skeleton files directory):

       o      source
              a  file  named source must exist in skeletons. It is installed in the destination directory `dest’
              that’s specified when calling icmstart(1). Example:

                  CLASSES

              skeletons/CLASSES is installed as dest/CLASSES;

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

                  dir/file

              skeletons/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             # skeletons/CLASSES is installed as
                                       #   dest/CLASSES
           dir/file dir/file           # skeletons/dir/file is installed as
                                       #   dest/dir/file
           ~/.icmake/file .icmake/file # $HOME/.icmake/file is installed as
                                       #   dest/.icmake/file

       Icmstart converts destination specifications to absolute paths. If these absolute paths do not begin with
       dest’s absolute path then 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).