------------------------------------------------------------------------
           SPWX11 - The Simplest Previewer in the World for X11R6
                   Version 1.0    (28 Feb 1997)

                       Hirotsugu Kakugawa
       Research Institute for Information Science and Education,
                      Hiroshima University
                email: kakugawa@se.hiroshima-u.ac.jp
------------------------------------------------------------------------
Table of Contents
 1. Introduction
 2. Invoking SPWX11
 3. Operation of SPWX11
 Appendix a. Installing SPWX11
 Appendix b. Supported platforms

------------------------------------------------------------------------
 1. Introduction
    SPWX11 is a very simple previewer on X-Window + Unix operating
    system for TeX.  It's length is less than 400 lines in C and
    it is the simplest previewer int world.
      The size of SPWX11 is less than 400 lines, it has following
    features: page caching, page continuation, paper size select.
      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 SPWX11 need to display the 
    interrupted page later, the page continuation feature restores 
    the intermediate page on window and continues from break-point.
    (SPWX11 implements this feature for the first time.)

------------------------------------------------------------------------
 2. Invoking SPWX11
    SPWX11 is invoked by he following syntax on command line of unix 
    shell.
       % spwx11 [Options] DVI-FILE
    You can give following option: 
      * -A1, -A2, ..., -A7, -B1, -B2, ..., -B7, -LETTER, -US, -LEGAL
                 Select paper size.
      * -l       Use the paper as landscape mode. (Rotate the paper 90 
                 degree.)
      * -m M     Magnify by M.
      * -v FILE  Select a vflibcap file (a font database file for VFlib).
                 It must be an absolute path.
      * -help    Print command line options and operations.

------------------------------------------------------------------------
 3. Operation of SPWX11
    SPWX11 provides only primitive user interface as follows:  
      * Mouse right button  --- Go to next page.
      * Mouse left button   --- Go to previous page.
      * q key               --- Finish SPWX11.

------------------------------------------------------------------------
 Appendix a. Installing SPWX11
    SPWX11 requires libdvi.a (a device independent DVI interpreter),
    VFlib, and kpathsea 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 SPWX11 directory. All TeX-Guy
       programs share the same config.h file; running configure script
       once is enough for compiling TeX-Guy programs.
         % cd .. [RET]
         % ./configure [RET]
    2. Run the 'make' at SPWX11 directory.
         % cd spwx11 [RET]
         % make [RET]
    That's it.

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