NAME

icmstart.rc - The icmstart(1) resource file

DESCRIPTION

The icmstart.rc file specifies files that are installed by icmstart(1).

A default icmstart.rc is found in /etc/icmake/icmstart.rc, but if $HOME/.icmake/icmstart.rc exists 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, or b character 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 (using skeletons below to refer to icmstart’s skeleton files directory):

o

source
a file named source must exist in skeletons. It is installed in the destination directory `dest’ that’s specified when calling icmstart(1). Example:

    CLASSES     


        

skeletons/CLASSES is installed as dest/CLASSES;

o

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

    dir/file


        

skeletons/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             # skeletons/CLASSES is installed as 


                                #   dest/CLASSES


    dir/file dir/file           # skeletons/dir/file is installed as


                                #   dest/dir/file


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


                                #   dest/.icmake/file


        

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