HYLAFAX TABLE OF CONTENTS
This is the table of contents for the documentation included with the
HylaFAX software distribution.
A version of this documentation is available on the main web site at
www.hylafax.org/toc.html.
If you are looking for ancillary materials such as the FAQ or
mailing list archives, consult the section on
supporting materials
BASIC INFORMATION
BUILDING FROM SOURCE
- How to build the software from source code
    
 The critical chapter to read when working with the source
    distribution.  The information in this chapter may also be useful to
    folks working with binary distributions.
    - Before You Start
	
 If you do not read this section before you run configure then
	you may do extra work and get pretty frustrated.
	- TIFF
	
- gcc
	
- C++ runtime libraries
	
- ghostscript
	
- gmake
	
- gawk
	
- sed
	
- /bin/test
	
- ps2fax binary for IRIX systems
	
 
- The Build Procedure
	
 When the software builds without a hitch you can
	ignore this stuff; but if not be prepared to spend some time
	reading the fine print.
	- Build Trees
	
- Configuration Files
	
- Configuring Packages
	
- Configuring the HTML Documentation
	
- Upgrading From FlexFAX
	
- A Sample Configuration Session
	
- Configuration Parameters
	
 
- Troubleshooting Build Problems
	
 Building this software is bulletproof; you'll never need this
	stuff...right!
- System-specific Guidance
	
 Information about pitfalls for specific systems are provided;
	some of this stuff is just too hard to handle automatically
	in the normal build support.
 
- Building Ghostscript for use with HylaFAX
    
 Quick help on what to do to create a version of Ghostscript suitable for
    use as the PostScript Raster Image Processor (RIP) that HylaFAX
    uses to image outbound facsimile documents.
SETUP INFORMATION
- Basic server configuration
    
 Step by step instructions on setting up a server machine once the
    software is installed from a source or binary distribution.
    This material describes only the basic work required to get a
    system running.
- Advanced server configuration
    
 Information about optional facilities provided
    by HylaFAX.  The material here is typically short and introductory
    with more complete information found in the reference documentation
    (manual pages).
    The last few sections give some background information about how
    the various modem-related configuration parameters fit together so
    that you can understand how the large set of tunable parameters can
    be most effectively used.
- Alpha-numeric pager support
    
 Setting up the optional facility for sending alpha-numeric messages
    to pager devices using the IXO/TAP or UCP communication protocol.
	- Setting up SNPP
	    
 SNPP is the protocol used by client applications to
	    submit requests to send pages.
- Setting up Pagesend
	    
 This is the backend program that does the actual delivery
	    of the a page request by talking IXO/TAP or UCP over a phone connection
	    to a paging service provider.
 
- How to setup a client.
    
 What to do to setup a system that is going to run only the
    client software.
- About server operation.
    
 Quick description of what goes on on a server machine and what
    administrative tasks must be managed for a server.  The material
    in this section is mostly a reiteration of information in other
    sections from an administration perspective.
- How to setup a mail to fax gateway
    
 It is simple to arrange for electronic mail messages to automatically
    get submitted as facimile.
    HylaFAX includes fairly extensive support for controlling the content
    and delivery of facsimile submited in this way.
TROUBLESHOOTING
- Troubleshooting HylaFAX Problems
    
 If you have a problem this is where to start.
    This chapter discusses the facilities provided by HylaFAX for
    diagnosing problems and gives specific examples of how to use them.
    There are also comments about the most frequently encountered problems.
    The material in this chapter is supplemented by the
    HylaFAX Frequently
    Answered Questions document (HylaFAQ) which is updated more
    frequently than this documentation and often contains information
    relevant to problems with specific distributions.
    - Client Basics
	
 If you are running a client command line application such as
	sendfax or faxstat and do not know where to begin
	then this is the place.
- Client Access Control Problems
	
 What to do when a server will not let you in
	but you think should be allowed.
	Be sure that basic communication with the server works
	before trying the advise given here.
- Server Basics
	
 Basic information that you need to get started debugging problems
	that might occur on a server machine.
	You will find information here about the tracing logs
	that are the key to understanding server problems.
- Scheduler Operation
	
 When the central scheduler will not process your job or it is not
	doing what you expect read this section.
- Session Tracing
	
 An introduction to the session tracing logs maintained for
	all phone calls serviced by HylaFAX.
- PostScript Document Preparation
	
 What to try when you just can not figure out why the PostScript
	document you submitted for transmission keeps getting rejected.
- TIFF Document Preparation
	
 TIFF documents are handled just like PostScript documents; sort of.
	If something goes wrong sending a TIFF document and you do not
	understand then look here.
- Communication Problems
	
 The most common area of frustration; some guidance and suggestions
	on what to do when a job does not go through.
- Getty Problems
	
 If you encounter problems arranging for inbound data calls to be
	handled look here.
- Problems With UUCP, cu, tip, etc.
	
 When HylaFAX and the normal system programs do not play together
	you may find this information useful in figuring out what is wrong.
- Alpha-numeric pager support
	
 A bit of advise on common problems encountered when using
	the IXO/TAP or UCP support.
 
SUPPORTING MATERIALS
END MATTER
 HylaFAX overview.
 HylaFAX overview.
webmaster@hylafax.org.
Last updated $Date: 1999/12/03 00:14:50 $.