/*
 * Copyright (c) 1993, 1994 Thomas W. Corson
 * Copyright (c) 1993, 1994 VetMark Systems, Inc. d.b.a Information Dynamics
 *
 * Permission to use, copy, modify, distribute, and sell this software and 
 * its documentation for any purpose is hereby granted without fee, provided
 * that (i) the above copyright notices and this permission notice appear in
 * all copies of the software and related documentation, and (ii) the names of
 * Thomas W. Corson, VetMark Systems, or Information Dynamics may not be used 
 * in any advertising or publicity relating to the software without the 
 * specific, prior written permission of Thomas W. Corson and VetMark Systems.
 * 
 * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
 * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
 * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
 * 
 * IN NO EVENT SHALL THOMAS W. CORSON OR VETMARK SYSTEMS, INC. BE LIABLE FOR
 * ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
 * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
 * WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
 * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
 * OF THIS SOFTWARE.
 */

FaxTool - Version 1.3	94/10/28

FaxTool is an OpenLook GUI front-end to FlexFax.  The tool is
internationalized to conform to I18N Level 3 (ie, most European
locales).

This version supports the following FlexFax commands:

	sendfax
	faxstat
	faxrm
	faxalter
	faxinfo


Capabilities:
------------

	Send
	----
		Optional Cover Page fill-in.

		Fax Phone Number Directory
	
		Document selection via File Chooser or Drag and Drop.
	
		Previewing of Postscript documents via Ghostscript.
	
		Transmission options for Notification, Transmission
		Time, Page Size, and Resolution.
	
	Status
	------
		Display of Receive or Send Queue.
	
		Rescheduling of pending Send Jobs.
	
		Modification of Notification Flags for pending Send
		Jobs.
	
		Cancellation and deletion of pending Send Jobs.	

		Viewing of Received Faxes.

		Printing of Received Faxes.


Differences between FaxTool 1.2 and FaxTool 1.3
-----------------------------------------------

	Fixed problem in send notify routine - char array not
	initialized to null.

	Increased maximum length of string arrays from 80 to 100.

	Added support for gcc compiler and options.

	Fixed misc. problems in function do_command.

	Ported tool to SVR4.

	Fixed problems with status functions when using another machine as the
	fax host.

	Fixed problem with "$" not being escaped on coverpage.

	Added support for I18N Level 3 Internationalization.

	Added faxtool man page.

	Added problem and request submission mechanism via GNATS.

	Fixed PRs:

     		330 faxtool  serious   medium
		Can't use status on remote host.

     		483 faxtool  analyzed  non-criti medium    
		Add gnats to faxtool distribution.

    		508 faxtool  serious   medium
		Faxtool drops dollar signs in the comments field of the 
		coverpage.

     		509 faxtool  non-criti medium
		Faxtool ignores Fax Host when querying status.

     		901 faxtool  non-criti low
		faxtool won't build on SVR4.

     		907 faxtool  non-criti low 
		faxtool needs a man page

     		908 faxtool  serious   medium
		Add I18N support to faxtool.

     		932 faxtool  serious   medium
		query of receive queue takes forever on remote server.

     		933 faxtool  serious   high
		Company Name does not print on coverpage.


Differences between FaxTool 1.2 and FaxTool 1.1
-----------------------------------------------

	Modified Makefile to add "debug" target.

	Added support for FAXSERVER environment variable.  Fax Host
	field on Properties popup now defaults to the value of
	FAXSERVER.  Send button processing now sets the sendfax -h
	option to the value stored in Fax Host.

	Fixed bug - Special characters not escaped before calling faxcover.

	Fixed bug - Clear button does not reactivate "Add To Directory"
	button.

	Fixed bug - "Add To Directory" button does not set textfields
	on directory popup.

	Fixed bug - Adding duplicate Fax Directory entry caused core
	dump the next time the scrolling list was selected.

Differences between FaxTool 1.1 and FaxTool 1.0
-----------------------------------------------

	Added a Fax Directory popup for maintaining and selecting
	Names and Fax Numbers.

	Added a Properties popup for specifying Fax Host, Spool
	Directory, and filters for Viewing, Printing, and Previewing faxes.

	Added fax id (filename) to Receive Queue display.

	Added capability to View, Print and Delete received faxes.

	All panels with scrolling lists are now resizeable and the
	scrolling lists expand/contract accordingly.  Similarly,
	FaxTool now lays out properly when invoked using the -scale
	Xview command line option.

	It is no longer necessary to have DevGuide installed in order
	to build FaxTool.  The distribution now includes the necessary
	DevGuide include files and libraries, as permitted by the
	DevGuide license agreement (NOTE, however, that these files
	cannot be redistributed except as a part of the complete
	FaxTool source distribution).  The Makefile has been modified
	accordingly to look for the environment variable GUIDEHOME, and
	if it is defined, to build FaxTool using DevGuide.  Otherwise,
	it uses the files in ./include and ./lib.  Note, however, that
	these libraries probably will not work unless you are running
	OpenWindows V3.0.

Requirements:
------------

	SunOS 4.1.x or Solaris 2.x
	OpenWindows 3.x
	DevGuide 3.0 (optional)
	An ANSI C Compiler
	FlexFax 2.1 or greater
	Ghostscript (for Previewing)

	I have successfully built and run this application on a
	SPARCstation 2 using:

		SunOS 4.1.3
		OpenWindows 3.0
		DevGuide 3.0
		SPARCcompiler C or gcc 2.3.3
		FlexFax 2.1 or 2.2
		Ghostscript 2.5.2

	I have also successfully built and run this application on a
	SPARCstation 10 using:

		Solaris 2.4
		OpenWindows 3.4
		DevGuide 3.0.1
		SPARCcompiler C
		FlexFax 2.1 or 2.2
		Ghostscript 2.5.2


Installation Notes
------------------

1) To build faxtool, cd to the directory where you have unpacked the
distribution and modify the Makefile to set BASEDIR to the directory
where you wish the binary, help files, and man pages to be installed.
Then type "make all". Then type "su root" and type "make install".

2) Building the "debug" target makes a version with symbols and which
also logs traces to stderr.

3) /var/spool/fax/bin/faxinfo must have world execute permission:

	chmod 755  /var/spool/fax/bin/faxinfo

4) The config file in /var/spool/fax/etc must specify at least 0644 in
order to be able to query the Receive Queue:

RecvFileMode:		0644		# recvd facsimiles *are* public


Internationalization Notes
--------------------------

Faxtool is internationalized through I18N Level 3.  This means that it
is possible to localize faxtool for most European languages.  To
produce the necessary localization (L10N) files:

1) Copy the files with extension ".po" from the directory where you
have unpacked the distribution to another working directory.

2) For each line which begins with "msgid", provide the desired
translated text on the line labeled "msgstr".

3) Save the resulting edits.

4) Run msgfmt on the edited files (eg, "msgfmt faxtool_ui_labels.po").
This will produce a file with a ".mo" extension.

5) Move the resulting ".mo" files to the appropriate locale directory
on your system.  This is typically "/usr/openwin/lib/locale/<your local
LANG variable>/LC_MESSAGES". 

	Eg, for French, /usr/openwin/lib/locale/fr/LC_MESSAGES

6) You may also edit and translate the file "faxtool.info" to provide
online help text in the local language.

7) If you develop a localized set of files for faxtool, I would
sincerely appreciate receiving copies of the resulting ".po" and
".info" files.  I will then add them to the distribution, along with
the appropriate acknowledgement, for the benefit of other users.


Reporting Bugs:
---------------

This distribution includes the ability to report problems, bugs, and
change requests via email using the GNU GNATS send-pr facility.  The
necessary files are installed when you do a "make install".  Please use
this problem reporting system for any and all requests.  To do so, type
"send-pr" and follow the instructions to fill out the form.  More
information can be found in the README in the send-pr subdirectory of
the distribution as well as the man page for "send-pr".

Known Bugs:
----------

1) There is an Xview bug (1071690) in OpenWindows 3.0 which causes the
   "Comments" multiline text field to be obscured when you switch from
   "Status" to "Send" mode.  There are 2 workarounds:

	a) Go ahead and enter data into the "Comments" field anyway. It
	will be there even if you can't see it :-).  You can then
	Preview the Cover Page, prior to adding the actual documents to
	send.

	b) Run 2 copies of the tool.  One for Send and one for Status.


If you a) enhance this application, b) successfully port it to other
platforms or environments, or c) fix any bugs, please email the
undersigned and include the system information for your platform along
with any changes which you made to FaxTool.  I will include these in
future releases along with the appropriate acknowledgement.

Acknowledgements
----------------

Thanks to following people for bug fixes and/or enhancements:

Peter Gross		pag@scg.boulder.co.us
Ian Darwin		ian@sq.com
Wolfgang Schweikert	schweikert@is.danet.de
Camden Clarke		cclarke%astatos.uucp@notable.com


I hope you find this software useful.

===============================================================================
	  Thomas W. Corson		  Information Dynamics
	  corson@infodyn.COM		  3031 Tisch Way
	  (Voice) 408-244-9700		  Suite 803
	  (Fax)   408-244-9724		  San Jose, California 95128

	        WWW: http://www.rahul.net/infodyn/id_home.html

	     => World Class Products For World Class Companies <=
===============================================================================
