ManViewer Copyright 2000, Horsburgh.com. All Rights Reserved.
Author: Steve Horsburgh, shorsburgh@horsburgh.com
Version: 0.9 (beta)

-----------
Description
-----------
ManViewer - A Web-enabled Manual Reader for Linux or Irix

The primary purpose of this tool is to allow remote access,
via a web browser, to the man pages on a Linux or Irix server.
ManViewer support manual browsing, keyword and phrase searching,
and page-to-page hyperlinks.

If you are directly attached to a server via X-windows,
there are much better viewers already available on your system.
If not, or if you have a slow connection to your server, then
check out this man page viewer.

ManViewer is simple to install, intuitive, and visually
appealing (or at least interesting). It is small since it
relies on the 'man2html' utility that comes with most Linux
and Irix systems.


-----------------
Required Software
-----------------
1. Linux Version 2.1 or greater or Irix Version 6.1 or greater.

2. Perl Version 5.002 or later (http://www.cpan.org/)

3. A Web Server -- Your own web server with CGI capability.

4. ManViewer requires the 'man2html' program.
     There a variety of versions. It probably came with
     your version of Linix or Irix.

-------------------------
Installation Instructions
-------------------------
1. Unpack the distribution into a directory of choice, preferably one
   owned by your web server.

   For LINUX systems:
         CMD: tar -zxf manview-0.9.tar.gz

   For IRIX systems:
         CMD: gunzip manview-0.9.tar.gz
         CMD: tar -xf manview-0.9.tar

2. Change to the new subdirectory.

   CMD: cd manview-0.9

3. Execute the setup file. (If you want to install into an existing
   Web Server area, make sure you are logged in as the Web Server user.)

   For LINUX systems:
           CMD: ./setup.sh

   For IRIX systems:
           CMD: ./setup.irix
   
4. Follow the instructions.

5. That's it.


--------------
Documentation
--------------

Sorry, I've not had the time yet...

Just go to the home page and click things. It should all be fairly
intuitive.

Point your web browser to the URL specified during setup.
For example:  http://localhost/cgi-bin/manviewer.cgi


-------
Testing
-------

ManViewer has been tested on the following platforms:
(if you have tested others, please let me know and I'll include them)

   - Redhat Linux 6.1, 6.2
   - SGI Irix 6.2, 6.3, 6.4

ManViewer has been 'view' tested with the following browsers:
(if you have tested others, please let me know and I'll include them)

   - Windows    Internet Explorer       4.72, 5.0, 5.5
   - Windows    Netscape Navigator      4.5, 4.7
   - Macintosh  Internet Explorer       5.0
   - Macintosh  Netscape Navigator      4.5, 6.0
   - Linux      Netscape Navigator      4.72


----
Bugs
----
ManViewer has been tested only on LINUX and IRIX systems.
Please let me know if it works on any other systems. If
you are the first to let me know, I'll include your name
in the CREDITS section.

Send all bug reports, comments, etc, to manviewer@horsburgh.com
Please include the version number.


-------
Credits
-------
Source Code: Steve Horsburgh  shorsburgh@horsburgh.com


---------
Copyright
---------
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  
02111-1307, USA.

See the file COPYING for additional information



ManViewer Copyright 2000, Horsburgh.com. All Rights Reserved.