ANNOUNCE: HylaFAQ update at ftp://ftp.sgi.com/sgi/fax/doc/

[Matthias.Apitz@SOFTCON.de (Matthias Apitz)]

I've just updated the HylaFAQ at

	ftp://ftp.sgi.com/sgi/fax/doc/hylafaq.tar.gz

and certainly it will also be updated in the next few days at

	http://www.vix.com/hylafax/FAQ/

Now there are a lot of new questions+answers (all about 188). Please
read (or search with the new search feature) carefully before
asking questions in the HylaFAX mailing list :-))

The MD5 checksum value of hylafaq.tar.gz is
MD5 (hylafaq.tar.gz) = c470ac6784a891a9c38befabeaf1cbe1

The information below is from the README of the HylaFAQ:

                 How to install the HylaFAQ-distribution
                    (release: 07:34:58 AM 01/27/97)
                       matthias.apitz@softcon.de


This is a living list of frequently asked questions about the HylaFAX
fax software system. The point of this document is to circulate existing
information, and to avoid rehashing old answers.  Better to build on top
than start again.  Please read this document before ever posting to
the HylaFAX mailing list (see Q13 how to subscribe to the list).

The HylaFAX FAQ is located at:

	ftp://ftp.sgi.com/sgi/fax/doc/hylafaq.tar.gz

in a easy-to-install form (see below).  The FAQ are hyper-linked
HTML pages ready to use for your favored browser.
Alternatively, a PostScript copy of a snapshot of this FAQ is also
available by public ftp in the directory
	
	ftp://ftp.sgi.com/sgi/fax/doc/hylafaq.ps.gz

The FAQ comes also with a small search engine. To enable this
feature you must copy over the perl script HylaFAQ/search.pl to
the cgi-bin directory of your HTTP server. See step 4) below.

The HylaFAX software and this FAQ were created by Sam Leffler
(sam@sgi.com). Since Nov. 1995 the FAQ is maintained by me, 
Matthias Apitz.

Your comments, additions and fixes to this document are welcome:
please send them to flexfaq@softcon.de by electronic mail.
You can also give feedback on specific questions through links
provided on each individual page.

Here is how to install - have fun.

1)	gnu-unzip and un-tar the archive;
	this will create a directory "./HylaFAQ" and the whole FAQ
	below this dir:

	$ gzcat faq.tar.gz | tar xvf -

2)	links to the HylaFAX man-pages or other online html-files
	are done from the FAQ by HREF's to the pattern:

		@HTMLPATH@/...	and
		@CGIPATH@/...

	there is a small shell-script (HylaFAQ/patch.sh) to change
	the patterns to reflect the location on your system, or to
	point to the HylaFAX-home page at www.vix.com; please modify
	this script, e.g. set:

          ROOT=${1-http://www.your-host.your-domain/hylafax/}
        CGIBIN=${2-http://www.your-host.your-domain/hylafax-cgi-bin/}

	or:

          ROOT=${1-http://www.vix.com/hylafax/}
        CGIBIN=${2-http://www.vix.com/cgi-bin/}

	and run

	$ cd HylaFAQ ; sh patch.sh

	The script patch.sh does also change the perl script
	HylaFAQ/search.pl to set the full qualified location
	of the HylaFAQ into the search script. If you later
	move your HylaFAQ to some other place you've to
	change this perl script by hand (you can't re-run the
	script patch.sh).

3)	to read the FAQ you don't need any httpd on your system;
	just start reading the HylaFAQ and fire up your favored
	browser (e.g.):

	$ cd HylaFAQ ; Mosaic index.php

	you may also want to collect all pages into one HTML-document
	for printing or converting to PostScript;

	$ cd HylaFAQ ; sh collect.sh > collect.php
	$ Mosaic collect.php

4)	If you want to enable the search tool of the FAQ you've to
	copy the script HylaFAQ/search.pl to the cgi-bin directory
	of your HTTP-server, e.g.:

	# cp HylaFAQ/search.pl /usr/local/httpd/cgi-bin/search.pl

Please report problems, bugs and new answers to me.

	matthias
-- 
firm: matthias.apitz@softcon.de [voc:+49-89-61308-351, fax: +49-89-61308-188]
priv: guru@thias.muc.de
 WWW: http://www.softcon.de/~guru/ OR http://www.guug.de/GUUG/firmen/apitz/

"We don't care.  We don't have to.  You'll buy whatever we ship, so why bother?
 We're Microsoft." (found in Usenet)