
krmprog(1)                   Khoros                    krmprog(1)

PROGRAM
     krmprog - A utility for removing routines from the khoros
     environment.

SYNTAX
     krmprog

     -name          program name

     -conf          input config file

     [-toolbox]     Toolbox name

     [-V]           Gives the version for krmprog

     [-U]           Gives the usage for krmprog

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called krmprog.ans or
                    file1

     [-a [file1]]   Uses krmprog.ans or file1 as the answer file

DESCRIPTION
     krmprog is a routine for removing routines from the khoros
     environment.  The driver program "krmprog" calls a shell
     script to do the work.  This command can be executed in the
     users work directory or in the directory above where the
     routine is located in src.  The routine to be removed can
     consist of a pane file (*.pane), a prog file (*.prog), a
     main.c file, a l*.c file, and a *.h file. Provision is made
     for an optional library include file.  The routine will
     prompt for a path for the destination of this file.  These
     files will be removed from the khoros source area as speci-
     fied by the paths in the config file (*.conf).

     There are four arguments to krmprog.  Two of the arguments
     are required; -name and -conf, while the other two arguments
     are optional.

     The -name argument specifies the name of the program to
     remove.  This should simply be the name of the program
     without any file type extensions.  For example, a valid name
     would be "vadd".

     The -conf argument specifies where to access the files asso-
     ciated with a specific routine. To correctly remove a rou-
     tine, the *.conf file must be filled out with the correct
     path information.  This file should exist in the program
     source directory.

     The -toolbox argument specifies which toolbox this routine
     will be installed in. Note, if the -toolbox argument is not
     used, then kinstall assumes that the routine is to be
     installed in KHOROS_HOME. Kinstall uses a mach file to
     determine where the top of the source is. This mach file is
     located in $TOOLBOX_NAME/repos/config/src_conf and is called
     ToolboxName_mf.

     The mach file specifies the information required by all of
     the khoros tools concerning the particular toolbox environ-
     ment, specific machine names, srcmach directories,
     TOOLBOX_NAME src location for each machine, and the top of
     the src directory for the local machine.  Note that if mul-
     tiple machines are used, then there should exist a mach file
     for each machine( i.e. ToolboxName_mf.joe.edu).  This is
     necessary since each machine may have a different path for
     the top of src, and the khoros tools require specific paths
     when linking files from one directory to another across dif-
     ferent machines with disk partitions mounted at different
     points.

     For information on toolboxes and mach files, see the Khoros
     Manual Vol. 2, Chapters 1 and 9.  Additionally, the program-
     mer may also wish to use the existing default mach file as
     an example located in $KHOROS_HOME/repos/config/src_conf
     called default_mach.

     Krmprog will prompt the user to edit the subform file and
     delete the reference to the pane file in the subform.
     Krmprog will automatically put the user in the editor speci-
     fied in their environment variable, or will default to use
     vi to edit the subform file.

     Krmprog will prompt for the inclusion of a library include
     file, which will be installed in the path specified by the
     programmer.

REQUIRED ARGUMENTS
     -name  type: string
            desc: program name

     -conf  type: infile
            desc: input config file

OPTIONAL ARGUMENTS
     -toolbox
            type: string
            desc: Toolbox name
            default: null

EXAMPLES
     krmprog -name vadd -conf vadd.conf

     Remove the program "vadd" from the locations specified in
     the config file (*.conf).  The default mach file in
     $KHOROS_HOME/repos/config/src_conf will be used to identify
     the locations of the src tree(s). Since no -toolbox argument
     is specified, vadd must exist in KHOROS_HOME

     krmprog -name vnew -conf vnew.conf -toolbox medic_toolbox

     Remove the program "vnew" from the locations specified in
     the config file (*.conf). krmprog will use the mach file
     $MEDIC_TOOLBOX/repos/config/src_conf/medic_toolbox_mf.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3) ghostwriter(1),
     intro(1), ghostreader(1), ghostcheck(1) ksrcconf(1), kmak-
     eall(1)

RESTRICTIONS
COPYRIGHT
     Copyright 1991, University of New Mexico.  All rights
     reserved.

Khoros                    Release: 1.0                          1

