Provided by: icmake_7.12.5-1_i386 bug

NAME

       icmstart - A startup script for icmbuild program maintenance

SYNOPSIS

       icmstart [Options] top-dir [program|library]

DESCRIPTION

       The  icmstart  script  is  a  generic  script that can be used to start
       program maintenance using  icmake(1)  and  icmbuild(1).  Icmstart  will
       create an initial directory top-dir and will install the files CLASSES,
       VERSION and icmconf below top-dir.  A  second  argument   ‘program’  or
       ‘library’  may  be  specified  as  the default mode of operation of the
       icmbuild(1) script.

       Skeleton files for the main directory and  subdirectories,  by  default
       listed  in  the  file /etc/icmake/icmstart.rc, may be installed as well
       (cf. icmstart.rc(7)).

       After changing to the directory created  by  icmstart  the  icmbuild(1)
       script may be used for program maintenance.

OPTIONS

       Icmstart may be called with the following options, which (if specified)
       must be the first arguments of icmstart:

       o      -c confpath
              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).

       o      -d
              Do  not  execute  any commands, but show the commands that would
              have been executed on the standard output.

       o      -I
              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.

       o      -s skeleton-path
              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 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, contains

           CLASSES
           main.cc
           main.ih
           usage.cc
           version.cc
           ? scanner
           ? parser

       This file is overruled by ~/.icmake/icmstart.rc. See icmstart.rc(7) for
       details about the format of the icmstart.rc file.

FILES

       The  mentioned  paths  are  sugestive  only  and  may  be  installation
       dependent:

       o      /usr/share/icmake/icmconf Example of  a  icmstart  configuration
              file;

       o      /usr/share/icmake/CLASSES Example of a icmstart CLASSES file.

       o      /usr/share/icmake/icmstart.rc Default skeleton resource file.

SEE ALSO

       icmake(1), icmbuild(1), icmstart.rc(7).

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