icmstart.rc(7)						      icmstart resource file						    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
	   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  instal-
       lation 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).

icmake.7.18.00.tar.gz						     1992-2012							    icmstart.rc(7)