README for xdocviewer 2.0
-------------------------

CHANGES since xdocviewer 1.0
----------------------------

xdocviewer 2.0 adds support for the Solaris 2.0 AnswerBook release, that being
AnswerBook 2.0 for Solaris 2.0.  It has been tested against the "minimal"
(i.e., completely on-disk) configuration of AnswerBook 2.0.

xdocviewer is a Perl language script that allows one to display Sun's
AnswerBook documentation on machines that only run plain X11 servers, such as
X terminals.  It makes these basic assumptions:

- You need AnswerBook installed somewhere, and the "bookinfo" file installed
  (default is /etc/bookinfo).  If you don't have a bookinfo file, you can
  create one by running the "answerbook_demo" script on the AnswerBook CD-ROM
  and then make an appropriate substitution of "../" to something else
  (like "/cdrom/" or "/usr/AnswerBook/SysSoft_1.3", for example).  Then install
  the "bookinfo" file somewhere, like /etc/bookinfo, or somewhere else (and
  then set your BOOKINFO env. variable appropriately).

- You need the XView libraries - libxview.so.3.x, libxview.sa.3.x, and
  libolgx.so.3.x and libolgx.sa.3.x - installed somewhere, either in a standard
  place (/usr/lib, /usr/local/lib, or in your X11 installation directory's lib
  directory) or somewhere else with the LD_LIBRARY_PATH variable set as
  appropriate to point to them.

- You need a GhostScript previewer.  The supported ones are ghostview 1.3 and
  gspreview 2.1.  Both of these support the "-page" option which allows you to
  bring up a document at a specific page, rather than at page 1.

- You need Perl (-:  This script was written using Perl 4.0.19.

Take the "xdocviewer" script, make it executable and change the first line to
point to wherever your "perl" executable lives, and fire it up.

If you have problems, bug reports or questions, send e-mail to the author:

	earle@poseur.JPL.NASA.GOV

Enjoy,

	- Greg Earle
	  Sun Microsystems, Los Angeles
	  JPL on-site Software Support Engineer
	  earle@poseur.JPL.NASA.GOV

