
Kraftsman(Toolbox Files)     Khoros      Kraftsman(Toolbox Files)

     TOOLBOX CONFIGURATION, DOCUMENTATION AND UIS FILES

     This section discusses the files important for toolbox crea-
     tion, configuration, and integration into the khoros system.

     Kraftsman creates the necessary toolbox user interface
     specification (UIS) files.

          {toolbox_home}/repos/cantata/subforms/{toolbox_name}.sub
          {toolbox_home}/repos/cantata/{toolbox_name}.form

     The file {toolbox_name}.form is a copy of the cantata UIS
     file from KHOROS_HOME/repos/cantata/cantata.form.  You will
     need to edit this file to include a reference to any subform
     files that you want cantata to use.  You will need to at
     least uncomment the following lines:

          -D 1 0 16x2+35+4.2 +0+0 'YOUR TOOLBOX ROUTINES' toolbox_name
          -u 1 0 16x1+25+4 'Your Toolbox Routines'
          -E

     to create a new menu button on the cantata master form.  The
     following line also needs to be added to reference the
     actual subform file.

          -k ${toolbox_home}/repos/cantata/subforms/{toolbox_name}.sub

     Kraftsman creates the necessary documentation files.  The
     file

          {toolbox_home}/doc/cantata/subforms/Overview.doc

     should be edited to provide on-line documentation of the
     subform.  The directory

          {toolbox_home}/doc/cantata/manpages

     is created for on-line help of the individual programs that
     you are going to install.  The kinstall program will prop-
     erly install and format the man1 documents for you.

     When a toolbox is being created by kraftsman, the following
     configuration files are created.

          {toolbox_home}/repos/config/imake_conf/{toolbox_name}.def
          {toolbox_home}/repos/config/src_conf/{toolbox_name}_mf

     These files are for the Imake system and the kinstall pro-
     gram.  Imake will reference the {toolbox_name}.def file for
     locations of bins, libs, etc.  The {toolbox_name}_mf gives
     the kinstall program information about compiling and mail-
     ing.

     And finally the Toolbox File itself is modified.  You should
     specify the location of your own Toolbox File with the
     environment variable, KHOROS_TOOLBOX.   For example,

     % setenv KHOROS_TOOLBOX $HOME/.Toolboxes

     Otherwise, the default Toolbox File is
     $KHOROS_HOME/repos/Toolboxes.

     Copyright 1992, University of New Mexico. All rights
     reserved.

Khoros                    Release: 1.0                          1

