NAME

       icmstart.rc - The icmstart(1) resource file

DESCRIPTION

       The  icmstart.rc  file  defines  the  initial  files  of  a  program 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
           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      Optionally: a P (don’t install with icmstart xxx library) or an  L  (don’t  install
              with icmstart xxx program), followed by a blank; see also icmstart(1).

       o      Optionall:  a  ?  (followed by a blank) following the optional P or L in which case
              the installation of the element must be confirmed by the user.

       o      Source path names. Relative path names are  interpreted  relative  to  the  current
              working  directory.  Environment  variables  are  not  expanded,  the initial tilde
              character is interpreset as the user’s home directory.

       o      Source path names followed by a destination (relative to the directory  initialized
              by icmstart(1)).  A source path may be either a file or a directory. If a directory
              is specified then all files in and below that directory will be installed.

       When specifying a destination a path may be specified as well.  However,  the  destination
       path  is  always interpreted relative to the installation directory specified when calling
       icmstart(1).

       If a destination is omitted, the source is  installed  as  specified  below  icmstart(1)’s
       destination directory.

EXAMPLES

       The following entries can be used in an icmstart.rc file:

       o      source
              `Source’  must be in the skeleton directory visited by icmstart(1) and is installed
              as source in the destination directory specified when calling icmstart(1).

       o      source dest
              `Source’ must be in the skeleton directory visited by icmstart(1) and is  installed
              as dest in the destination directory specified when calling icmstart(1).

       o      ~/path
              `~/path’ is installed as ~/path in the destination directory specified when calling
              icmstart(1). The ~-character is expanded to the user’s home directory.

       o      ~/path dest
              `~/path’ is installed as dest in the destination directory specified  when  calling
              icmstart(1). The ~-characteris expanded to the user’s home directory.

       o      /path
              `/path’  is installed as ./path in the destination directory specified when calling
              icmstart(1).

       o      /path dest
              `/path’ is installed as dest in the destination directory

       o      ? source
              The user must confirm the installation of source.

       o      ? source dest
              The user must confirm the  installation  of  source  as  dest  in  the  destination
              directory specified when calling icmstart(1).

       o      # text
              Interpreted  as comment and ignored. The #-character must be the first character on
              the line.

       o      an empty line
              Empty lines are skipped.

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