bionic (7) icmstart.rc.7.gz

Provided by: icmake_9.02.06-1_amd64 bug

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

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

AUTHOR

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