 COPYRIGHT (c) 1986-1993 FRAME TECHNOLOGY CORPORATION

 This source code contained herein is proprietary and confidential
 information of Frame Technology Corporation, San Jose, CA and is 
 covered by the U.S. and other copyright and trade secret protection.
 Unauthorized adaptation, distribution, use, or display is prohibited
 and may be subject to civil and criminal penalties. Disclosure to
 others is prohibited. For the terms and conditions of source code
 use, refer to your Frame Technology source code license agreement.

 $Id: README.VUE,v 1.3 1993/04/16 18:26:37 tvb Exp $
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
                        HP Visual User Environment
                       SAIC Visual User Environment

   This README file explains Frame products' support of the Visual User
   Environment (VUE) for HP and SAIC. It describes the files you need to
   copy to your home directory to fully integrate a Frame product with VUE
   2.01 and 3.0, and describes how to start a Frame product in the VUE
   environment.

                        VUE FILES AND DESCRIPTIONS

   The following is a description of the VUE files and instructions you
   need to fully integrate a Frame product with VUE.

       FILE                           DESCRIPTION
       =-=-                           =-=-=-=-=-=
  README.VUE                 This is a README file.
  .vue/vuewmrc               Symbolic link file to the vuewmrc file for 
                             VUE 2.01 or VUE 3.0.
  .vue/vuewmrc_2.01          vuewm is a start-up file for VUE 2.01.
  .vue/vuewmrc_3.0           vuewm is a start-up file for VUE 3.0.
  bitmaps/frame_rib.bm       Frame logo for the Front Panel of VUE 2.01.
  .vue/icons/frame_rib.bm    Frame logo for the Front Panel of VUE 3.0.
  .vue/icons/frame_rib_m.bm  Frame logo mask for the Front Panel of VUE 3.0.
  .vue/icons/frame.l.bm      Large bitmap used by the VUE 3.0 File Manager.
  .vue/icons/frame.l_m.bm    Large bitmap mask used by the VUE 3.0
                             File Manager.
  .vue/icons/frame.s.bm      Small bitmap used by the VUE 3.0 File Manager.
  .vue/icons/frame.s_m.bm    Small bitmap mask used by the VUE 3.0
                             File Manager.
  bitmaps/frame.l.bm         Symbolic link file to ../.vue/icons/frame.l.bm.
  bitmaps/frame.s.bm         Symbolic link file to ../.vue/icons/frame.s.bm.
  .vue/types/frame.ft        File Manager file type definitions for VUE 2.01.
  .vue/types/frame.ad        File Manager action definitions for VUE 2.01.
  .vue/types/frame.vf        File Manager file type and action definitions
                             for VUE 3.0.

Running a Frame product from your home directory:
   The symbolic link vuewmrc file points to the appropriate vuewmrc file
   of the VUE version you use. By default, the link points to vuewmrc_2.01.
   - If you use VUE 2.01, you can run a Frame product from the 
     fminit/samplehome directory without changing the link.
   - If you use VUE 3.0 and you prefer to run your Frame program from your
     home directory, copy vuewmrc_3.0 to your home directory and name it
     "vuewmrc". If you already have a $HOME/.vue/vuewmrc file, compare yours
     with the version we provide, and then change yours accordingly.

Adding the main Frame window to the VUE Front Panel:
   The vuewmrc file provides the capability to place the main Frame window
   onto the VUE Front Panel. By default, this capability is commented out.
   Remove the comment tags from the vuewmrc file to change the default.

Adding the Frame icon to the VUE 2.01 Front Panel:
   The bitmaps/frame_rib.bm file provides the icon for the Front Panel for
   VUE 2.01. Copy the frame_rib.bm file to your $HOME/bitmaps directory.

Adding the Frame icon to the VUE 3.0 Front Panel:
   The icons/frame_rib.bm and icons/frame_rib_m.bm files provide the icon for
   the Front Panel for VUE 3.0. Copy these files to your $HOME/.vue/icons
   directory.

Adding the Frame icon used by the VUE 3.0 File Manager:
   The frame.l.bm, frame.l_m.bm, frame.s.bm, and frame.s_m.bm files provide
   the large and small icons for the VUE 3.0 File Manager. Copy these files
   to your $HOME/.vue/icons directory.

   The bitmaps/frame.l.bm file is a symbolic link file pointing to the
   .vue/icons/frame.l.bm file, and the bitmaps/frame.s.bm file is a symbolic
   link file to the .vue/icons/frame.s.bm file.

Representing Frame files with Frame icons on the VUE File Manager:
   The .vue/types/frame* files determine which files in the File Manager
   get Frame icons.
   - For VUE 2.01, only files with the extensions .doc, .mif, or .mml have
     a Frame icon. If you use VUE 2.01, copy the frame.ft and frame.ad
     files to your $HOME/.vue/types directory.
   - VUE 3.0, by default, examines the content of each file to determine
     whether it's a Frame file or not. For VUE 3.0, this behavior can be
     configured (see the comments in the .vue/types/frame.vf file for
     additional information). If you use VUE 3.0, copy the frame.vf file
     to your $HOME/.vue/types directory.

               STARTING A FRAME PRODUCT IN THE VUE ENVIRONMENT

   When you start a Frame product, you should include the following
   command-line options:

   -log_file_only           Logs output only to the log file, not to your
                            VUE errorlog file. This prevents Frame product
                            messages from being logged in your VUE
                            errorlog file. Use this option with the
                            -console_log [<file>] option.

   -console_log [<file>]    Turns on console logging to a file. The [<file>]
                            argument is the name of an optional alternate log
                            file. The default for [<file>] is 
                            $HOME/fmconsole.log. Use this option with the
                            -log_file_only option.

   -run_in_fg:              Runs the Frame process in the foreground. This
                            avoids a conflict with "stty tostop" and prevents
                            the shell from exiting before the Frame product
                            starts.

   These command-line options are automatically included if you start a
   Frame product by clicking the Frame icon on the VUE Front Panel. When you
   click the Frame icon, you get the following results:
   - If a Frame product is already running, the main Frame window appears.
   - If no Frame product is running, the program specified in the vuewmrc
     file starts. The default program is FrameMaker. See the comments in
     the vuewmrc file to find out how to change the default program.

   When you double-click a file represented by a Frame icon or drag the file
   to the Frame icon on the Front Panel, you get the following results:
   - If a Frame product is already running, the file opens.
   - If no Frame product is running, the program specified in the FM_PROGNAME
     variable starts and then the file opens. If the FM_PROGNAME variable
     is not set, the default program (FrameMaker) starts. See your VUE
     documentation for setting environment variables in VUE.

   Note: Frame recommends that you start a Frame product by clicking the
   Frame icon on the Front Panel rather than by dragging the file to the
   Frame icon.
