home | help 
icmstart.rc(7)		     icmstart resource file		  icmstart.rc(7)

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  icm-
     start(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

     The icmstart.rc file may contain:

     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 spec-
	    ification.

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  ar-
	    gument;

     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 icm-
     start.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  icm-
	    start(1). Example:

		CLASSES

	    skeletons/CLASSES is installed as dest/CLASSES;

     o	    pathspec
	    if	`pathspec'  does  not begin with a slash it must exist in skele-
	    tons.  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 path-
	    spec's final element is installed in the destination directory spec-
	    ified 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 specifi-
     cation 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

     Icmstart converts destination specifications to absolute  paths.  If  these
     absolute paths do not begin with dest's absolute path then 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  Pub-
     lic License (GPL).

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

icmake.9.03.01.tar.gz		    1992-2020			  icmstart.rc(7)
home | help