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 printing 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 optionally 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 formatter 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 directory. 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 follows:

      % 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 output to the printer. When new postscript files are regenerated, 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 printing.

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.