Basic installation: the files VERSION, usage.cc and version.cc are not installed, and the #define USE_VERSION entry in icmconf is commented out.
Use the configuration files (icmstart.rc, AUTHOR, YEARS and VERSION) if found in confpath rather than in ~/.icmake and/or /etc/icmake/. Once a file is found it is used allowing partial overrides of the default files provided by icmake(1).
Do not execute any commands, but show the commands that would have been executed on the standard output.
Do not install files.
|o||-r Unconditionally replace existing files. If -r is not provided icmstart will ask the user to confirm that an existing file must be overwritten. If a skeleton specification refers to a directory, the full directory and its subdirectories will be replaced.|
By default skeleton files are listed in the skeleton resource file /usr/share/icmake/icmstart.rc. Alternatively, the skeleton resource file may be specified by the ICM environment variable, which -in turn- may be overruled by the path specified with the -s option. The skeleton path may be specified as a full file-path or as a directory, in which case the skeleton resource file is assumed to be icmstart.rc (see below at SKELETON FILES). Since icmstart uses cp to install files, cp must be available when icmstart should install skeleton files.
Skeleton resource files may contain comment (empty lines and lines beginning with the hash-mark (#)) which is ignored, and should otherwise contain specifications of resource s to install.
The default resource file is /etc/icmake/icmstart.rc, containsThis file is overruled by ~/.icmake/icmstart.rc. See icmstart.rc(7) for details about the format of the icmstart.rc file.
CLASSES P main.cc P main.ih P usage.cc P version.cc P ? scanner P ? parser
The configuration files icmstart.rc, AUTHOR, YEARS and VERSION are recognized and processed by icmstart.
If the -c option was specified configuration files found in the path specified at this option are used. If not specified or if a file isnt found then the path ~/icmake is inspected. If a configuration file isnt found in ~/icmake either, configuration files in /etc/icmake are used.
Configuration files are not required for the proper operation of icmstart. When absent icmstart performs the following default actions:
o If the file AUTHOR does not exist icmstart uses #define AUTHOR . When the file AUTHOR is defined in a configuration path it should have one line, defining the author of the program. E.g.,
#define AUTHOR Frank B. Brokken <email@example.com>
o If the file VERSION does not exist icmstart uses #define VERSION 0.00.00. When the file VERSION is defined in a configuration path it should have one line, defining the programs initial version. E.g.,
#define VERSION 1.00.00
o If the file YEAR does not exist icmstart uses #define YEARS yyyy where yyyy is the current year. When the file YEAR is defined in a configuration path it should have one line, defining the programs initial release year. E.g.,Plural is used here since a release year usually becomes a range of years after some time, as with Icmakes years specification:
#define YEARS 2012
#define YEARS 1992-2012
o If the file icmstart.rc does not exist (or is empty) icmstart will not install any of the files normally found in icmstart.rc, but the initial project directory, icmconf and VERSION are installed. )
The mentioned paths are sugestive only and may be installation dependent:
o /usr/share/icmake/icmconf Example of a icmbuild configuration file; o /usr/share/icmake/CLASSES Example of a icmbuild CLASSES file. o /usr/share/icmake/icmstart.rc Default skeleton resource file.
icmake(1), icmbuild(1), icmconf(7), icmstart.rc(7).
This is free software, distributed under the terms of the GNU General Public License (GPL).
Frank B. Brokken (firstname.lastname@example.org).