image: fax1.gif


english/fax.tex
Version 1.1
Document 1.1

15/11/1996

Contents

Introduction

This is a programm that lets you compose, send, receive and view faxes. It is a graphical frontend to a fax spooling programm like mgetty+sendfax.

You may interactively build up your fax messages, adding plain text and other files (text, pictures). You may select the recipient from a database or may just enter his fax number directly.

You may query the status of the fax subsystem, listing both incoming and outgoing faxes. Faxes may be displayed on your screen or may be sent to a printer.

Here are some highlights

This programm is also available as a commercial version. This version adds the following features:

Using the Fax Programm

Starting the Programm

  The programm may always be started by giving an absolute Pathname

??/SW/bin/fax

In the above example you have to substitute the double question marks with the path where you have installed the programm. If you add the SW/bin subdirectory to your PATH environment variable then you may just enter fax to start the programm.

The programm tries to restore the state from the previous invocation, that is you will have the same options and settings as when you left the programm the last time. If you don't like this behaviour, start the programm with the fax -ns option.

You may get a list of command line options by starting the programm with fax -?

Main Window

 

The main window of the programm allows you to create a fax, select the receiver and then send the fax. Here is a screenshot of the main window:

image: fax2.gif

As you can see the main window consists of a notebook-type widget with the following tabs:

image: fax3.gif

Receiver
This is the place where you may either enter a fax number or select one of the recipients from the fax database
Message
Here you may compose a short (one-page) message to the receiver. This is normally the front-page of a multi-page fax message.
Attachements
You may add any file or any window on the screen.
Options
This is a space to modify the different option settings for the sent fax.

At the bottom of the main window you find the following buttons:

image: fax4.gif

Send
If you are ready with composing your fax then a simple click on this button hands off the fax to your fax spooler.
View
Popup a list of all incoming faxes for viewing. See the section on The Status Window.
Fax Status
Displays a list of all currently queued outgoing faxes. See the section on The Status Window.

The Receiver Window

 

The easiest way to enter a fax number is to use the corresponding entry field. A fax number can contain spaces and the special chars (),-_/. If you also enter the name of the receiver then this name will be displayed instead of the bare fax number when showing the status (and it will also be shown on the titlepage of the outgoing fax).

A more comfortable way to select a fax number is to use the alias feature. The combo-box list all currently know aliases (these come from different sources - when you are using faxspool then the corresponding databases are read in (see faxspool(1)) and from an internal database. Selecting an alias inserts all the known information about it into the corresponding fields (eg fax number, name, company). Of course you may edit this information to your needs.

You may add a new alias with the New Alias button or modify an existing alias (the currently displayed one) with the Modify Alias button. Deleting an existing alias is also easy - clicking on Del Alias deletes the currently displayed alias.

When you don't know the alias but are sure that a user is in the fax number database then you may enter part of the name, the phone number or the company and the programm will search for a match in its database when you click on Search.

Clearing all fields is accomplished with the Clear button.

All these operations also have keyboard shortcuts - just have a look at the Edit-Menu.

Adding and Modifying Aliases

  A small window pops up on your screen with the appropriate entry from the fax number database in it. You may modify each of the fields at will but are required to provide a unique alias field.

Here is a screenshot:

image: fax5.gif

Clicking on Save saves the entry and also makes it the current receiver in the main window. Cancel leaves the entry as it was before you edited it.

The Message Window

  In this window you may enter text that will be put on the header page of your fax. It is not intended to produce fancy looking multi-page output but only as a small description of the fax or some notes to the recipient.

If both the Subject- and Message fields are empty then no header page is created at all. In this case the fax message consists of the attachements only.

The Attachements Window

  The attachements window lets you add additional pages to your fax message. You may either add files or grab windows on your screen.

image: fax6.gif

You may select any file that can be converted by the faxspool programm into a fax file. Currently these are the following:

The Options Window

 

This window allows you to manipulate certain parameters of the sent fax.

image: fax7.gif

The resolution of the sent fax may be changed between normal, and fine which means that a different driver is used for the conversion of files into FAX format.

When the send after field is not empty then it contains a time after which the fax should be sent (eg because of lower costs). This time is in HH:MM twenty-four hour format.

The coverpage is the first page of the fax. In normal operation the faxspool software uses no coverpage at all (unless you have already installed one - see the manual). With faxit you may change between different coverpages at will. You may even combine your logo and the message text on the same page (see the demo directory for examples).

The same is true for the page header (normally configured when installing the mgetty+sendfax software. This is the header put on every page of the fax.

Both of these options are only usefull if you create the corresponding files (or shell scripts) and add them to the configuration file /.SW/fax.cfg. See the Configuration section below.

In the sender field you may enter your full name or any other text that you think is applicable to identify you as the sender. This is put on every page of the fax and on the title page too. By default this text is extracted from you password entry.

The Main Menu

  Here is a description of some of the more interesting entries in the main menu:

image: fax8.gif

Options/Wrap Word
this options lets you switch wordwraping in the message window on or off. Please note that this has no consequences on the final output, long lines are always truncated (currently this is related to a deficiency in the faxspool programm).

Setup/Config Printer
Before you can print a fax from within faxit you have to configure a corresponding printer. If you have installed faxpr (also in the mgetty+sendfax-package, then just enter faxpr %f as print command and you are done. Otherwise you need a command (or command pipeline) that converts raw g3 Fax files to your printer format.

The Status Window

     

This window is used to display the status of incoming and outgoing faxes.

image: fax9.gif

All the received faxes (found in the fax/incoming subdirectory of the fax spooler system) are displayed with their sender fax number and the number of pages. Just click on of the jobs and select View to display this fax or Print to print it.

image: fax10.gif

You may also delete a fax (provided you have the permissions). Additionaly you may wrap up a fax into a MIME-compliant message and send it to another user via email (on the local or on a remote host). This is especially usefull for fax administrators.

You may select more than a single fax by holding down the Shift-Key while clicking on additional entries.

image: fax11.gif

Configuration

  There are a lot of configuration variables that can be tailored to your needs. Most of them can be conventiently changed by using the configuration editor (available under the Menu Setup/Config. Printer Setup is available when you select Setup/Config Printer.

Some configuration information is obtained by directly reading the correpsonding configuration files of the underlying fax software. You may for example add a new fax number to you personal /.faxnr file (which is used by faxspool). You may also directly modify /.SW/FaxNumbers.cfg to add additional entries (though this may be done by using the New Alias button).

Other things can only be configured by creating or modifying the corresponding configuration files directly. Among them are the available cover pages and header lines (the contents of the menubuttons Coverpage and Page Header).

Please look into SW/demo for examples of these files. To add a new title page you add an entry in /.SW/fax.cfg (or in the global configuration file ??/SW/cfg/fax.cfg) that follows the conventions shown in the example file. Name is the name of the cover as it appears in the menubutton and Command is the command to run to create such a coverpage (see coverpg(1) for details). As you can see some special character sequences (the %? things) are replaced by actual values so your programms/scripts may use any desireable calling convention.

Here is a list of supported sequences

%s
this is replaced by the contents of the subject field from the message-window.
%m
this is replaced by the message text from the message-window.
%p
number of pages
%i
id of sender
%u
user name of sender
%f
fax number
%d
name of receiver
%D
current date
%T
current time

Your programm should create (on standard output) a file that can be fed to faxspool to create the coverpage of the fax message. See the example shell script demo/shoftworks.sh which substitutes some magic values in a postscript file created with xfig.

To add additional fax-headers just create a new entry (again follow the examples) and let the File-statement point to a file that follows the conventions provided by faxspool(1m) programm.

Copyright

The programm faxit is available in two version:

Copyright for the Public Domain Version

This version is fully functional and contains essentially the same features as the commercial version. Missing are the package selection mechanism, the direct connection to emacs and some of the export formats. The public-domain version is a lot slower as it uses more tcl-level routines.

There is no guarany that the public-domain version will be available any longer, that it will be supported or that any bugs will be fixed.

This software may be used, copied, modified and distributed for free as long as the copyright stays intact and you don't make any money from it.

Copyright for the Commercial Version

This version is fully functional and contains all the features described in the previous chapters. With the purchase of this software you are entitled to use the services of softWorks (maintenance, support, upgrades). Ask for more details about the commercial version of faxit (or just start the license-manager and select faxit).

Generic Copyright Terms

This programm contains parts with their own copyrights like Tcl and its extensions TclX, Tk, Blt and Tix. These packages are all freely available from the internet.

IN NO EVENT SHALL THE AUTHOR OF THIS SOFTWARE BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE AUTHOR OF THIS SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

THE AUTHOR OF THIS SOFTWARE SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE AUTHOR OF THIS SOFTWARE HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

Additional information may be found in the document General Business Policy and Terms of Delivery.

Changes

Version 1.1

This is the first version made available to the public. The subversion 1.1.1 is the public domain version, 1.1.2 is the commercial version.

Known Bugs

Currently there are no known bugs. There are probably some minor inconveniences hidden deep inside the program...



softWorks
Richard Schwaninger
Wed Nov 13 17:58:02 MET 1996