english/fax.tex
Version 1.1
Document 1.1
15/11/1996
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:
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 -?
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:
As you can see the main window consists of a notebook-type widget with the following tabs:
At the bottom of the main window you find the following buttons:
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.
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:
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.
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 lets you add additional pages to your fax message. You may either add files or grab windows on your screen.
You may select any file that can be converted by the faxspool programm into a fax file. Currently these are the following:
This window allows you to manipulate certain parameters of the sent fax.
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.
Here is a description of some of the more interesting entries in the main menu:
This window is used to display the status of incoming and outgoing faxes.
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.
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.
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
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.
The programm faxit is available in two 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.
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).
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.
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.
Currently there are no known bugs. There are probably some minor inconveniences hidden deep inside the program...