faxview(1)

NAME
faxview - a simple file dialog for managing fax messages.

SYNOPSIS
faxview

DESCRIPTION
FAXview is a user interface to view, print and delete incoming fax messages. You should be able to use FAXview if you know how to handle a serial pointing device (some aliens call such devices `mouse'). Thus, stop reading here unless you want to know the secrets of live, the universe and anything else. There are five major regions in the dialog. The top-most entry-field labeled Selected filenames displays the currently selected filename. Multiple filenames have to be separated with spaces. All names are relative to the current working directory and may contain globbing patterns. Typing Return in the entry-field invokes the viewing command on all selected files. The second entry-field labeled Type of file and the two list-boxes Files and Directories represent the actual file dialog. You can select a file from the Files list-box with a single-click on the first mouse-button. A double-click invokes the viewing command on the file underneath the mouse cursor. Dragging the mouse while holding mouse-button one down selects multiple files. A double-click in the Directories list-box changes the current working directory and updates the contents of the list-boxes. The globbing pattern specified in the Type of file entry-field controls the contents of the Files list-box (entering a directory name selects all files in that directory; things like `~user' are of course allowed). Typing Return in the Type of file entry-field updates the contents of the Files and Directories list-boxes. The Collect pages check-button of the Files list-box controls whether multiple filenames with a unique base-name are listed on a single line using a brace globbing pattern or not. Enabling this feature is the only way to view multiple files with a simple double-click. This appeals to the laziness of most users. The two entry-fields Viewing command and Printing command below the file dialog specify the command to be used for viewing and printing the selected files. The check-button Single filenames decides whether the token $f will be replaced with all selected filenames or if the command will be invoked for each filename separately. You must put an ampersand & at the end of the command line if you want to execute the command asynchronously. You also have to obey the rules of the Tcl-command exec if you want to redirect any file handles. Example entries for viewing and printing are
     xli -pixmap $f & and
     g3topbm $f | pbmtolps | lpr & The Return key is bound to invoke the entered command within these two entry-fields. The last window named Process information logs most actions and it is used to display warning and error messages, too. You can control if the lines should be truncated or wrapped with the check-box Wrap lines. After all, there are six push-buttons at the bottom of the dialog. The View and Print button invoke the corresponding command from the Viewing command and Printing command entry-fields. The Remove button deletes the selected files after your confirmation. The Update button can be used to re-read the contents of the current directory. You can go back to your startup directory with the Home button (in case you get lost in the file system). The right-most button Exit terminates FAXview. This event is globally bound to the Escape key, too.

OPTIONS
There are none.

ENVIRONMENT
See the manual page of your shell for how to set environment variables.

FAXVIEW
    The startup directory of FAXview. Users who get their fax messages delivered from a real fax administrator can set this variable to their own spool directory. The directory `/var/spool/fax/incoming' will be used as the startup directory if the FAXVIEW variable is not set.

SEE ALSO
Tcl/Tk is a programming system for developing GUI applications written by John K. Ousterhout. You need at least the windowing shell wish(1) to run faxview(1). mgetty(1) from the mgetty+sendfax package written by Gert Döring <gert@greenie.muc.de> allows to use a fax modem for receiving fax messages and handling external logins without interfering with outgoing calls. xli(1), xloadimage(1), xv(1) and display(1) (the last one is from the ImageMagick package) can be used to view fax pages under X directly. All these programs are much slower than viewfax(1) (AKA viewfax(1)) written by Frank D. Cringle <fdc@cliwe.ping.de> because it is highly optimized for fax messages received by mgetty(1) (it takes less than a second to display an average fax page). g3topbm(1) from the pbmplus, netpbm or mgetty+sendfax package may help you to convert a fax page into other formats.

BUGS
Bugs are by far the largest and most successful class of entity. (Prof. Snopes' Encyclopedia of Animal Life)

AUTHOR
Ralph Schleicher <rs@purple.in-ulm.de>. FAXview is free software and comes with ABSOLUTELY NO WARRANTY; see the GNU General Public License as published by the Free Software Foundation for details.