University of Hamburg
Department of Computer Science
-- Computing Center --

Schlueterstr. 70
D-2000 Hamburg 13
Germany

EMail: markus@rz.informatik.uni-hamburg.dbp.de		(author)
       friesland@rz.informatik.uni-hamburg.dbp.de	(general contact)

+-----------------------------------------------------------------------+
! README file for DECwindows and OSF/Motif based TeX DVI-Preview driver !
! for VAX/VMS							        !
! 5-july-90 Christian Markus					        !
+-----------------------------------------------------------------------+

DISCLAIMER:
The Preview programs and their source code are supplied on an 'as is' 
basis. I regret any liability for any damage, inconvenience or malfunction
caused by these programs. There might still be errors in the programs
itself or in the documentation, please contact me if you find any errors.

Please read the instructions (provided in the corresponding directories)
carefully, they are .DVI files and can be easily printed with any driver.

The port to OSF/MOTIF is based on fieldtest-software supplied by DEC,
dating from october 1989. In the USA this may have been replaced by
a never version, so an adaptation may be required.
The document DVIMOTIF.TEX includes a 'porting report' to illustrate
the changes that had to be made for the transition DECwindows --> OSF/MOTIF.

There are four directories and two files:

  [dvi_fbi_hh.beebe]    contains all .H files from the Beebe driver V2.10
			(FINDPOST.H and GBLVARS.H contain error-corrections!)
			and the original documentation DVIxxx.*
  [dvi_fbi_hh.includes] contains all modified .H files
  [dvi_fbi_hh.dvimotif] contains source code for OSF/Motif DVI Preview
  [dvi_fbi_hh.dvidecw]  contains source code for DECwindows DVI Preview
  DXM_LOGICALS.COM      command file to set up OSF/Motif devel. environment
  README.TXT		this file	

Required TeX-fonts:

  The Preview is designed to work with 69 dpi fonts in order to show a
  full page layout on the screen. However for proof-reading a base
  resolution of 83 (or 100) dpi is more desirable and sufficient for
  most page formats if page-offsets are discarded (option).
  The higher resolution can be achieved by 'zooming' (option) or by
  using a run-time option, e.g.: DVIDECW -m1 -q

  Besides a minimal set of 69 dpi fonts, a full range of fonts starting
  at 83 dpi and extending into the usual 300 dpi range is supplied.


/************************************************************************/
/* Filename: DVIDECW.C						    	*/
/* Function: Program to view TeX DVI ouput file in a DEC-Windows Envir-	*/
/*	     onment							*/
/* (c) 1990 by Christian MARKUS, Fachbereich Informatik,		*/
/*             Schlueterstr. 70, D 2000 Hamburg 13, Fed.Rep.of Germany	*/
/*									*/
/* EMAIL   :         markus@rz.informatik.uni-hamburg.dbp.de		*/ 
/*          or via   friesland@rz.informatik.uni-hamburg.dbp.de		*/
/*----------------------------------------------------------------------*/
/* Program History:							*/
/*									*/
/* Ver#: ! Date:  !Comment:				!Author:        */
/* ------+--------+-------------------------------------+-------------- */
/* 1.0   !04.07.89!First version			!Ch. Markus	*/
/* 1.1   !09.03.90!Corrected and updated		!Ch. Markus	*/ 
/*		  !- get/set bit/byte order correctly	!		*/
/*		  !- one window/automatically adjusted  !		*/
/*		  !- window size can be changed		!		*/
/*		  !- Scrollbars available		!		*/
/*		  !- Title contains info		!		*/
/* 		  !- Copy to Clipboard			!		*/
/* 1.2   !19.06.90!- adaption for ANSI-C/VAX-C 3.1	!Ch. Markus	*/
/*----------------------------------------------------------------------*/
/* Program description:							*/
/*									*/
/* This driver works in a DECWindows environment and is based on TEX	*/
/* DVI-driver family developed by N.Beebe, Utah, USA. The include files	*/
/* are taken from version 2.10, the driver DVIDECW is based on the	*/
/* DVIBIT driver. Instead of using download fonts it creates a bitmap 	*/
/* (similar to DVIJET) and displays it in the output window upon a	*/
/* window exposure event. Upon each interactive command, the bitmap is	*/
/* created again.							*/
/*----------------------------------------------------------------------*/
/* Installation guide:							*/
/* 									*/
/* - modify the TEXVIEW.COM file to suit your system's paths		*/
/* - in FileView, select the Customize/Verbs and Menus option		*/
/* - enter a new verb name 'TeX Preview' below the verb names box and	*/
/*   click on enter button upon completition				*/
/* - enter the DCL command for the 'Tex Preview' verb, that is entering	*/
/*   somewhat like @<path>texview.com and clicking on the 'enter' button*/
/* - select a menu from the 'Menu Names' box and click on the 'Add'	*/
/*   button below the 'Verbs in Menu' list box.				*/
/* - press 'Apply' and 'Ok' button to install new item in menu bar	*/
/* - select the Customize/File Types option and install the .DVI file	*/
/*   type.								*/
/*----------------------------------------------------------------------*/
/* Quick guide to operations:						*/
/* 									*/
/* Invoke DVIDecw in four different ways:				*/
/* - from a DECTerm terminal window 					*/
/*   -> just type the command,options and filename to be processed	*/
/* - from the FileView DCL Command window				*/
/*   -> just type the command,options and filename to be processed	*/
/* - by selecting a FileView menu item (if TEXVIEW.COM is installed)	*/
/*   -> a dialog box pops up asking for a filename, a second box will	*/
/*      ask for any processing parameters				*/
/* - by double-clicking on any .DVI file (if TEXVIEW.COM is installed	*/
/*   and the File Types box is set for .DVI files			*/
/*   -> a dialog box pops up asking for processing parameters		*/
/*                                                                      */
/* All options of DVIBIT are accepted, but the -o option (order pages)	*/
/* is ignored, DVIDecw will only pick the first selected page		*/
/* The program will create a command and an output window and display	*/
/* the first selected page.                                             */
/* All interactive commands can be selected from menus and should be 	*/
/* easy to understand. 							*/
/* If the TeX Preview window has the 'Input focus' key equivalents	*/
/* provide a shortcut for some menu commands. To set the input focus,	*/
/* just click into the Tex Preview window, the window title will change	*/
/* to the highlight color.						*/
/*----------------------------------------------------------------------*/
/* The following files taken from the original BEEBE driver have been	*/
/* modified (using #if compiler switches) for DECWINDOWS:		*/
/*									*/
/* DISPCHAR.H -> make up for reversed Y-coordinate origin		*/
/* DVIFILE.H  -> change program structure to event-driven calls		*/  
/* FATAL.H    -> don't perform resetterm() function in DECW environment	*/ 
/* GBLPROCS.H -> modifications to conform with ANSI-C (Vax C 3.1)	*/
/* MACHDEFS.H -> changed FONTPATH, FONTLIST and DVIHELP for OS_VMS     	*/
/* OPENFONT.H -> allow open files according to MAXOPEN,quota and avail.	*/
/* PRTPAGE.H  -> changes in EOP case and keyboard status request	*/ 
/* SETCHAR.H  -> make up for reversed Y-coordinate origin		*/
/* SETRULE.H  -> make up for reversed Y-coordinate origin		*/
/*----------------------------------------------------------------------*/
/* The DVIDecw package contains the files listed below:			*/
/* 									*/
/* DVIDOC_D.DVI Installation/User's Guide in GERMAN			*/
/* DVIDOC_E.DVI Installation/User's Guide in ENGLISH			*/
/* DVIDECW.C	Main C source code, all DECWindows specific coding	*/
/* DVIDECW.UIL	User Interface description file				*/
/* DVIDECW.COM  Compile,UIL and link command procedure			*/
/* DVILINK.COM  Link DVIDECW for other VMS versions			*/
/* TEXVIEW.COM	Command procedure for FileView invocation of DVIDECW	*/
/* xxxxxxx.H    Include files (listed above) modified for DVIDECW	*/
/************************************************************************/





/************************************************************************/
/* Filename: DVIMOTIF.C						    	*/
/* Function: Program to view TeX DVI ouput file in a OSF/Motif Envir-	*/
/*	     onment							*/
/* (c) 1990 by Christian MARKUS, Fachbereich Informatik,		*/
/*             Schlueterstr. 70, D 2000 Hamburg 13, Fed.Rep.of Germany	*/
/*									*/
/* EMAIL   :         markus@rz.informatik.uni-hamburg.dbp.de		*/
/*	    or via   friesland@rz.informatik.uni-hamburg.dbp.de		*/
/*----------------------------------------------------------------------*/
/* Program History:							*/
/*									*/
/* Ver#: ! Date:  !Comment:				!Author:        */
/* ------+--------+-------------------------------------+-------------- */
/* 1.0   !04.07.89!First version			!Ch. Markus	*/
/* 1.1   !09.03.90!Corrected and updated		!Ch. Markus	*/ 
/*		  !- get/set bit/byte order correctly	!		*/
/*		  !- one window/automatically adjusted  !		*/
/*		  !- window size can be changed		!		*/
/*		  !- Scrollbars available		!		*/
/*		  !- Title contains info		!		*/
/* 		  !- Copy to Clipboard			!		*/
/* 1.2   !19.06.90!- OSF-Motif Version			!Ch. Markus	*/
/*		  !- adaption to ANSI-C/Vax-C 3.1	!		*/
/*----------------------------------------------------------------------*/
/* Program description:							*/
/*									*/
/* This driver works in a OSF/MotifDEC environment and is based on the	*/
/* DVI-driver family developed by N.Beebe, Utah, USA. The include files	*/
/* are taken from version 2.10, the driver DVIMotif is based on the	*/
/* DVIBIT driver. Instead of using download fonts it creates a bitmap 	*/
/* (similar to DVIJET) and displays it in the output window upon a	*/
/* window exposure event. Upon each interactive command, the bitmap is	*/
/* created again.							*/
/*----------------------------------------------------------------------*/
/* Installation guide:							*/
/* 									*/
/* - modify the TEXVIEWM.COM file to suit your system's paths		*/
/* - in FileView, select the Customize/Verbs and Menus option		*/
/* - enter a new verb name 'TeX Preview' below the verb names box and	*/
/*   click on enter button upon completition				*/
/* - enter the DCL command for the 'Tex Preview' verb, that is entering	*/
/*   somewhat like @<path>texviewm.com and clicking on the 'enter'button*/
/* - select a menu from the 'Menu Names' box and click on the 'Add'	*/
/*   button below the 'Verbs in Menu' list box.				*/
/* - press 'Apply' and 'Ok' button to install new item in menu bar	*/
/* - select the Customize/File Types option and install the .DVI file	*/
/*   type.								*/
/*----------------------------------------------------------------------*/
/* Quick guide to operations:						*/
/* 									*/
/* Invoke DVIMotif in four different ways:				*/
/* - from a DECTerm terminal window 					*/
/*   -> just type the command,options and filename to be processed	*/
/* - from the FileView DCL Command window				*/
/*   -> just type the command,options and filename to be processed	*/
/* - by selecting a FileView menu item (if TEXVIEWM.COM is installed)	*/
/*   -> a dialog box pops up asking for a filename, a second box will	*/
/*      ask for any processing parameters				*/
/* - by double-clicking on any .DVI file (if TEXVIEWM.COM is installed	*/
/*   and the File Types box is set for .DVI files)			*/
/*   -> a dialog box pops up asking for processing parameters		*/
/*                                                                      */
/* All options of DVIBIT are accepted, but the -o option (order pages)	*/
/* is ignored, DVIMotif will only pick the first selected page		*/
/* All interactive commands can be selected from menus and should be 	*/
/* easy to understand. 							*/
/* If the TeX Preview window has the 'Input focus', key equivalents	*/
/* provide a shortcut for some menu commands. To set the input focus,   */
/* just click into the Tex Preview window, the window title will change	*/
/* to the highlight color.						*/
/*----------------------------------------------------------------------*/
/* The following files taken from the original BEEBE driver have been	*/
/* modified (using #if DECWINDOWS compiler switch) for OSF/Motif:	*/
/*									*/
/* DISPCHAR.H -> make up for reversed Y-coordinate origin		*/
/* DVIFILE.H  -> change program structure to event-driven calls		*/  
/* FATAL.H    -> don't perform resetterm() function in DECW environment	*/ 
/* GBLPROCS.H -> modifications to conform with ANSI-C (Vax-C 3.1) 	*/
/* MACHDEFS.H -> changed FONTPATH, FONTLIST and DVIHELP for OS_VMS     	*/
/* OPENFONT.H -> allow open files according to MAXOPEN,quota and avail.	*/
/* PRTPAGE.H  -> changes in EOP case and keyboard status request	*/ 
/* SETCHAR.H  -> make up for reversed Y-coordinate origin		*/
/* SETRULE.H  -> make up for reversed Y-coordinate origin		*/
/*----------------------------------------------------------------------*/
/* The DVIMotif package contains the files listed below:		*/
/* 									*/
/* DVIDOC_D.DVI Installation/User's Guide in GERMAN			*/
/* DVIDOC_E.DVI Installation/User's Guide in ENGLISH			*/
/* DVIMOTIF.C	Main C source code, all OSF/Motif specific coding	*/
/* DVIMOTIF.UIL	User Interface description file				*/
/* DVIMOTIF.COM Compile,UIL and link command procedure			*/
/* DVILINKM.COM Link DVIMOTIF for other VMS versions               	*/
/* TEXVIEWM.COM	Command procedure for FileView invocation of DVIMotif	*/
/* xxxxxxx.H    Include files (listed above) modified for DVIMotif	*/
/************************************************************************/