
                       DVIprintSetUp V3.87
                       ===================

                           - Freeware -

                        by Stefan Scherer
                            28.12.1993

General Information
===================

DVIprintSetUp  provides easy use of the PasTeX printer driver DVIprint.  It
is  intended  for  use  with  the  previewer ShowDVI and replaces the ARexx
script  "StartDVIprint.sd".   The  GUI contains the major print options and
can  be  used  (almost)  completely  via  the  keyboard.  The program needs
KickStart V37 or higher.  DVIprintSetUp is Freeware.

With  the  program DVIprintSetUp it is very easy to start the print process
from ShowDVI.  The simple ARexx script coming with the PasTeX drivers could
only  handle  page ranges.  The irritating selection with "OK" and "Cancel"
and  the  missing  option  settings  made  me  write this program.  Now the
printer, the page offsets and several other options can conveniently be set
and saved as permanent defaults.


Installation
============

1.   Copy  the program "DVIprintSetUp" to the directory "TeXMF:bin/pastex".
   The ARexx script looks there for the program.

2.    Copy  the  ARexx  script  "StartDVIprintSetUp.sd"  to  the  directory
   "TeXMF:pastex/rexx".

3.   Now  you  have  to  modify  the  ShowDVI configuration.  Load the file
   "TeXMF:pastex/config/ShowDVI.config"  into  your editor.  You can either
   overwrite the function key attached to the print process, or introduce a
   new         function         key.         The        ARexx        script
   "TeXMF:pastex/rexx/StartDVIprintSetUp"  has  to  be  linked to this key.
   Save the changed configuration.

4.   If  you  were  using  the  environment variable "DVIPRINT" before, you
   should remove all entries that can be influence via DVIprintSetUp, i.e.,
   the  page offsets, the printer, and several other values.  In "DVIPRINT"
   only static values should be stored, e.g., the size of the font buffer.

This  finishes  the installation.  Now load a DVI file to ShowDVI and press
the print button.  The DVIprintSetUp window will appear.  Here you can make
changes  to  the  other  default  settings.   You should save your personal
choices for DVIprintSetUp and start a test print.


Invocation
==========

DVIprintSetUp  is  called  via  the  ARexx script "StartDVIprintSetUp.sed",
which  is  activated  by  a function key as defined in ShowDVI.config.  The
program  has two parameters:  the name of the DVI file and the current page
number  for  the initial setting of the "From" and "To" page range gadgets.
These values are automatically provided by the ARexx script.

On invocation the DVIprintSetUp window appears on the ShowDVI screen, or if
this  is  not  present,  on  the WorkBench screen, and the "From" gadget is
active.   The page range begins and ends with the current page number.  For
normal  printing  the  (default)  settings  are  correct  and only the page
numbers have to be changed, e.g., to print several pages at a time.

Additionally  several  options  for  DVIprint  can  be  changed,  e.g., the
horizontal  and  vertical  page offset and their measure units, the setting
for  continuous  range  printing,  odd  or even pages only, the output file
(which  could  well  be  "NIL:"),  and  the other switches described in the
DVIprint documentation.


Online-Help
===========

When active, DVIprintSetUp provides a context sensitive "Help" function (in
German  only).   By clicking on the gadgets or <return>ing the text gadgets
the  relevant  help  text  is  displayed.   All  functions  and switches of
DVIprintSetUp  are  disabled in help mode (even "Save" and "Print") and are
reset on leaving the help function.


Technicalities
==============

The    program    DVIprintSetUp    uses    its   own   configuration   file
"TeXMF:pastex/config/DVIprintSetUp.config"   for   permanently  saving  the
settings.   In  addition to that the program remembers the settings used in
the  last printing process (except for the page numbers) in the environment
variable  "DVIPRINTSETUP"  for  the  next print job.  This variable is lost
when  rebooting  the  machine.  This allows for temporarily saving modified
settings without overwriting the permanent defaults.


Author
======

Please send bug reports and suggestions to the author.

                Stefan Scherer
                Abt-Wolf-Straße 17
                96215 Lichtenfels, Germany
                Tel: 09571/6203
