icmstart.rc

Langue: en

Version: 303153 (debian - 07/07/09)

Section: 7 (Divers)

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 This is free software, distributed under the terms of the GNU General Public License (GPL).

AUTHOR

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