/* * 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//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 <= ===============================================================================