NAME¶

icmstart.rc - The icmstart(1) resource file

DESCRIPTION¶

The icmstart.rc file specifies the files 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


    icmconf


    P main.cc 


    P main.ih 


    P usage.cc


    P version.cc


    P ? scanner 


    P ? parser  


        

o

empty lines, which are ignored;

o

lines beginning with a hash-character (#), also ignored;

o

an optional installation mode followed by a source-destination specification.

INSTALLATION MODE¶

An installation mode consists of a combination of:

o

either a P (don’t install with icmstart xxx library) or an L (don’t install with icmstart xxx program);

o

a D, indicating that the source must also be installed by default, i.e., if neither `program’ or `library’ was specified as second argument.

o

a b, indicating that the file must not be installed if the -b (basic installation) option was specified when calling icmstart.

o

Following the optional P, L, D, b combination a space delimited optional ? may be specified. If specified the installation of the file or directory must be confirmed by the user.

SOURCE-DESTINATION SPECIFICATIONS¶

The following source-destination specifications can be used in an icmstart.rc file:

o

source
A plain name must exist in the icmstart’s skeleton directory. It is installed in the destination directory `dest’ specified when calling icmstart(1). Example:

    CLASSES     


        

skeletondir/CLASSES is installed as dest/CLASSES

o

pathspec
If `pathspec’ does not begin with a slash it must exist in icmstart’s skeleton directory. It is installed as `pathspec’ in the destination directory specified when calling icmstart(1). Example:

    dir/file


        

skeletondir/dir/file is installed as dest/dir/file

o

/pathspec or ~/pathspec The ~-character is expanded to the user’s home directory. The pathspec’s final element is installed in the destination directory specified when calling icmstart(1). Example:

    ~/.icmake/file


        

$HOME/.icmake/file is installed as dest/file When the above source specifications are followed by a destination specification destspec (a file or non-absolute directory specification) then the source specification is installed as dest/destspec) below the destination directory specified when calling icmstart(1). Examples:

    CLASSES CLASSES             # skeletondir/CLASSES is installed as 


                                #   dest/CLASSES


    dir/file dir/file           # skeletondir/dir/file is installed as


                                #   dest/dir/file


    ~/.icmake/file .icmake/file # $HOME/.icmake/file is installed as 


                                #   dest/.icmake/file


        

Icmstart conveerts the destination specification to a full path specification. If this full path specification does not begin with dest’s full path specification an error message is displayed and icmstart ends.

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