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
main.cc
main.ih
usage.cc
version.cc
? scanner
? parser
The icmstart.rc file may contain:
o empty lines are ignored;
o lines beginning with the hash-character (#) are ignored;
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.
The first character of a line may be a question mark (followed by white
space, a source path and optionally a destination path. In this case
the user is asked to confirm that the source path should indeed be
installed.
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 a icmstart.rc configuration
file;
o /usr/share/icmake/CLASSES Example of a icmstart.rc CLASSES file.
o /usr/share/icmake/icmstart.rc Default skeleton resource file.
SEE ALSO
icmake(1), icmbuild(1), 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).