icmstart.rc(7)

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