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