
prnmanual(1)                 Khoros                  prnmanual(1)

PROGRAM
     prnmanual - Interactive script for formatting and printing
     the Khoros manual

SYNTAX
     prnmanual

     An interactive script

DESCRIPTION
     prnmanual is an interactive script for formatting and print-
     ing the Khoros manual.  Prnmanual presents the user with a
     listing of the current Volumes and Chapters comprising the
     Khoros manual.  From the list, the user is prompted to enter
     the desired Volume and Chapter to be formatted and option-
     ally printed.  A postscript file for the selected Chapter is
     created in the corresponding manual directory, which may
     then be sent to a printer if desired.

     Options exist for entering the type of roff text formatter,
     the printer command, and the printer name.  Several types of
     roff text formatters are available on various systems,
     therefore the user should investigate the type of text for-
     matter available on their system.  The default is set as
     "eroff", but can be overridden by entering the name of
     another roff formatter on the system.

     Since printer commands vary from one site to another, the
     user is prompted for the printer command.  This is usually a
     command in the form of "lpr".  The default is "lpr".
     Printer names are also variable, therefore the user is
     prompted for the name of the printer.  This is also usually
     a name in the form of "lw" or "laserwriter".  There is no
     default for the printer name.

     The user has the option of sending the postscript file to
     the printer or simply creating a postscript file in the
     directory of the corresponding chapter of
     KHOROS_HOME/manual.  Note that at some sites, there may be a
     limit on the size of the postscript file to send to a
     printer. If you encounter an error when trying to print the
     postscript file, it may be necessary to go into the
     corresponding chapter subdirectory of KHOROS_HOME/manual and
     execute the roff command manually.  After running the
     prnmanual program, there will be a "*.ms" file in the direc-
     tory.  This file can be converted to several smaller
     postscript files by executing the roff command with the -o
     option specifying the range of page numbers to print. An
     example of this using the "eroff" text formatter is as fol-
     lows:

           % eroff -ms chapter.ms -p -o1-100 > chapter_part1.ps

           % eroff -ms chapter.ms -p -o101-200 > chapter_part2.ps

     Postscript files for each chapter in $KHOROS/HOME/manual
     exist as compressed postscript files.  The prnmanual script
     uncompresses the files at print time and redirects the out-
     put to the printer.  When new postscript files are regen-
     erated, they are not in compressed form.

     A selected Chapter from the Khoros manual may be printed
     from the following menu, which is presented to the user when
     running the interactive script:

         Volume 0 - Accessory Chapters

               Chapter 0 - Preface
               Chapter 1 - Glossary
               Chapter 2 - Changes - from Beta release

         Volume 1 - Khoros User's Manual

               Chapter  0 - Title and Contents
               Chapter  1 - Getting Started
               Chapter  2 - Cantata
               Chapter  3 - Xprism2
               Chapter  4 - Xprism3
               Chapter  5 - Editimage
               Chapter  6 - Animate
               Chapter  7 - Warpimage
               Chapter  8 - Viewimage
               Chapter  9 - Concert
               Chapter 10 - Other Programs

         Volume 2 - Khoros Programmer's Manual

               Chapter  0 - Title and Contents
               Chapter  1 - Writing Programs / VIFF format
               Chapter  2 - User Interface Specification
               Chapter  3 - Preview
               Chapter  4 - Composer
               Chapter  5 - Ghost Routines
               Chapter  6 - Conductor
               Chapter  7 - Trouble Shooting
               Chapter  8 - Khoros Libraries
               Chapter  9 - Configuration Management
               Chapter 10 - Installation Guide

         Volume 3 - Khoros Reference Manual

               Chapter 0 - Title and Contents
               Chapter 1 - Man(1) Pages
               Chapter 2 - Man(3) Pages

EXAMPLES
     prnmanual

     This will take the chapter.man file selected from the
     interactive script and generate a postscript file for print-
     ing.

SEE ALSO
     intro(1), bldmanual(1)

RESTRICTIONS
     Will reply with "No match" in certain directories that do
     not contain *.sec files.  This message can be ignored.  All
     .so lines in the *.man and *.sec files MUST begin with
     KHOROS_HOME/....

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

Khoros                    Release: 1.0                          1

