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