------------------------------------------------------------------------
                              xldvi
                     Version 2.4.1  (28 Oct 1997)

                       Hirotsugu Kakugawa
                  email: h.kakugawa@computer.org
------------------------------------------------------------------------
Table of Contents
 1. Introduction
 2. Invoking XLDVI
 3. Operation of XLDVI
 4. Customizing XLDVI
 Appendix a. Installing XLDVI
 Appendix b. Supported platforms

------------------------------------------------------------------------
 1. Introduction
    XLDVI is a simple previewer on X-Window version 11 release 6
    + Unix operating system for TeX.  
      XLDVI has following features: page caching, page continuation, 
    paper size select, and dynamic magnification change.
      Page drawing in progress may be interrupted by next page command, 
    for example. At interruption, intermediate result of the page drawing
    and break-point is remembered; when XLDVI need to display the 
    interrupted page later, the page continuation feature restores 
    the intermediate page on window and continues from break-point.

------------------------------------------------------------------------
 2. Invoking XLDVI
    XLDVI is invoked by he following syntax on command line of unix 
    shell.
       % xldvi [Options] DVI-FILE
    You can give following option: 
      * -A1, -A2, ..., -A7, -B1, -B2, ..., -B7, -LETTER, -US, -LEGAL
                      Select paper size.
      * -m M          Magnify by M. (Default values is 1.0.)
      * -l            Use the paper as landscape mode. (Rotate the 
                      paper 90 degree.)
      * -v FILE       Select a vflibcap file (a font database file for VFlib). 
      * -fg COLOR     Select the default color for characters.
      * -bg COLOR     Select the default color for background (paper).
      * -frame COLOR  Select the color for paper frame.
      * -back COLOR   Select the color for background (window).
      * -cache N      Cache N preview pages.
      * -no-eps       Skip EPS figures.
      * -eps-{mono,gray,rgb}   Draw EPS figures in Monochrome/Grayscale/RGB.
      * -text-{mono,gray,rgb}  Draw text in Monochrome/Grayscale/RGB.
      * -epsf.sty     Interpret DVI file is made by epsf.sty on LaTeX 2.09 
      * -help         Print command line options.
      * -help-key     Print key and mouse operations.
      * -license      Show software license.

------------------------------------------------------------------------
 3. Operation of XLDVI
    XLDVI provides only primitive user interface as follows:  

    Page Move
      * Mouse right button  --- Go to next page.
      * Mouse left button   --- Go to previous page.
      * <                   --- Go to the first page.
      * >                   --- Go to the last page.

    Magnificaion
      * ]                   --- Magnify. 
      * [                   --- Shrink
      The window size it self does not change by '+' and '-' commands.
      They just displays magnified text in fixed-size window. Thus, 
      the window is just a `peep-hole' of paper.  If the text is
      magnified enough, not all area is visible. The following
      commands move the 'peep-hole'. 
      * Ctl-f (Right Arrow Key)  --- Move visible area right.
      * Ctl-b (Left Arrow Key)   --- Move visible area left.
      * Ctl-p (Up Arrow Key)     --- Move visible area up.
      * Ctl-n (Down Arrow Key)   --- Move visible area down.
      * }                   --- Enlarge window. 
      * {                   --- Shrink window.
    Quit
      * q key               --- Finish XLDVI.

------------------------------------------------------------------------
 4. Customizing XLDVI
   4.1 Specifying parameters on compilation
       Parameters are defined file 'cf-xldvi.h'. Please modify this
       if necessary.

   4.2 Specifying parameters on invocation.
       You can specify parameters in a resource file 'Xldvi'.
       (Resource names are descrived in 'cf-xldvi.h'.) 'Xldvi.ad' is
       an example resource file.

------------------------------------------------------------------------
 Appendix a. Installing XLDVI
    XLDVI requires libdvi.a (a device independent DVI interpreter),
    libVFlib.a libraries.  You must compile these libraries
    in advance.

    1. Run the 'configure' script at top directory of TeX-Guy package,
       i.e., the upper directory of XLDVI directory. All TeX-Guy
       programs share the same config.h file; running configure script
       once is enough for compiling TeX-Guy programs.
         % cd .. [RET]  (if you are in xldvi directory.)
         % ./configure [RET]
    2. Run the 'make' at XLDVI directory.
         % cd xldvi [RET]
         % make [RET]
    That's it.

------------------------------------------------------------------------
 Appendix b. Supported platforms
    * FreeBSD 2.1 for IBM PC/AT compatible
    * FreeBSD 2.2 for IBM PC/AT compatible
    * SunOS 4.1 for SUN SPARC Station
------------------------------------------------------------------------
