Installation Instructions

News Peruser uses the EZ Widget and Graphics Library to create its
user interface, and the UUDeview decoding library to decode encoded
binaries. In order to compile and run News Peruser, you must therefore
retrieve and install EZWGL and UUDeview first. 

The next major release, News Peruser 4.0, is another rewrite, this
time in C++, with a small embedded evaluator to interpret a subset of
scheme for automation purposes, and will use Bill Spitzak's wonderful
fltk toolkit for its X interface. I intend to release new versions of
3.x for bug fixes, but will add no new functionality to 3.x. All 
development effort is going into 4.0.

----------------------------------------------------

You may find EZWGL here: 

http://www.ma.utexas.edu/~mzou/EZWGL

Follow the installation instructions in the EZWGL documentation.

-----------------------------------------------------

And you may find UUDeview here:

http://http://www.informatik.uni-frankfurt.de/~fp/uudeview

The UUDeview package includes two command line utilities and a TCL/TK based
program, to decode and encode binary files to and from a number of formats.

Once you have compiled both libraries, you must edit the News Peruser Makefile
to reflect the location of the toplevel directory of the UUDeview source. Edit
the line:

UUDEVIEW_PATH=/usr/local/src/uudeview-0.5.13 

accordingly. 

------------------------------------------------------

You may wish to alter other directories defined at the top of the
Makefile as well. Then, in the toplevel Peruser source directory type "make
install." By default the executable, peruser, gets shoved into /usr/local/bin,
the helper program nplister gets put into /usr/local/libexec/peruser, and the
help files all get placed into /usr/local/lib/peruser. If you'd like to change
these locations, edit the variables at the top of the Makefile.

News Peruser requires that your home directory be on an ext2 filesystem.

If it crashes on you, don't hesitate to send me a core dump, or a patch, or
perhaps just a description of what's going on, and be sure say what version
you are running. 


James Bailie
jbailie@wwdc.com
http://www.wwdc.com/~jbailie
