PN 93000173B XDigiFAX FAX System Version 1.1.0 Release Notes Software Package P/N 75000173B Diskette P/N 40001083B V1.1.0 (3.5", X-Windows) Diskette P/N 40001084B V1.1.0 (5.25", X-Windows) Diskette P/N 40001162A V1.1.0 (3.5", X-Windows AIX) DISKETTES All of the software diskettes included with this product are specially formatted to be readable by both tar and cpio. This means that they can be read using either the SCO XENIX custom command, or by the installpkg command found on UNIXWare 1.1. Although your operating system may support installation of either of these types of formats, we recommend that for UNIXWare, you run the installpkg command and for ODT 2.0 or 3.0 you use the Custom command. XdigiFAX ships from the factory on 3.5" diskettes. 5.25" diskettes are no longer shipped by default. If you need 5.25" diskettes, they are available by calling Digiboard Technical Support. WHATS CHANGED FROM THE PREVIOUS RELEASE? o Support was added for Cannon BubbleJet Printers. o Support was added for scanning tiff images. See the section on 'Scanning' below in the release notes. A WORD ABOUT MOTIF ON UNIXWARE 1.1 The applications contained on this disk use the shared libraries of Motif, thereofor you must have the Motif shared library package installed on your machine in order to run xdigifax or any of its associated GUI applications. DO I STILL NEED MY OLD DIGIFAX SOFTWARE? Yes. xdigifax is a front end for the command line based digifax programs. As such it calls many of the digifax programs. For this reason xdigifax cannot run standalone, it needs to co-exist with digifax. The xdigifax product disk will not change or delete any of the non-X Windows based digifax files. - 1 - PN 93000173B XDigiFAX FAX System Version 1.1.0 CAN I MIX USAGE OF XDIGIFAX AND DIGIFAX? Yes. Using xdigifax will not interfere with the use of the character based product. ODT and UNIXWARE DESKTOP SUPPORT xdigifax supports both the UNIXware and ODT desktop drag and drop metaphors. If you are running UNIXWare you may need to run the script digifax-dt to install the desktop icons into your desktop. If you double-click on the ODT Applications icon you will see all of the applications which have been installed, including a new DigiFAX System icon. If you double-click on this icon you will reveal icons for accessing several of the DigiFAX commands. For quicker access, remember that the Desktop Manager lets you drag and leave any of these icons out onto your desktop. Double clicking on the Send a FAX icon will bring up the send window. Dropping one or more file icons onto the Send a FAX icon will cause the send window to popup with the names of the dropped files preloaded into the Files: list. Dropping a file icon onto the View a FAX icon will cause the fax viewer, xfaview, to be run on that file. FILE CONVERSION Most any file can be converted to a fax format file quickly and simply. Dropping a file icon onto the Convert File To .fax icon will convert that file to a fax format file and put the result in a file with the .fax suffix. The following rules are used: - Dropping a a .tif, .gif, .bmp, .p[bgp]m, or .pcx file onto the Convert File To .fax icon will cause the imagecvt program to be run to convert the file to a .fax file. The image will be scaled as needed to make it as wide as a FAX page. - Dropping a a .mm, .man, .ms, or .[1-8] or file onto the Convert File To .fax icon will use the jetroff program to convert the troff document to a .fax file. The appropriate macro package(s) will be used. The JetRoff commands and fonts disks, as well as DWB troff must be installed. - 2 - PN 93000173B XDigiFAX FAX System Version 1.1.0 - Dropping a file icon for a .pcl or a .ps file onto the Convert File To .fax icon will use the faxjet or ps2fax printer emulators. - Any other file type not listed above will use the text2fax program. Note: The conversion programs mentioned above key off the file name suffix not the contents of the file, therefor it is important to use consistant file naming practices. UNIXWARE 1.1 DESKTOP This version contains icons and rules which support the drag-and-drop metaphor of the UnixWare 1.1 desktop. You must have digifax 2.8.0 or later installed in addition to this package. In order for the DigiFAX icons to appear on a user's desktop, each user must the command (once): $ digifax-dt Once these icons are installed and the desktop has been restarted, the icons work as described above under ODT 2.0. The only exception is that the UNIXWare desktop does not handle dropping more than one file icon on a program icon properly; only one file icon should be dropped at a time. XDIGIFAX RESOURCES xdigifax contains all of its required resources internally, and therefor no resource or defaults file is shipped. Invoking xdigifax with the -resources flag causes it to dump these resources to its standard out file descriptor. This output may be used as an .Xdefaults file. Below are some of the more interesting values that can be set, along with some explanation: - 3 - PN 93000173B XDigiFAX FAX System Version 1.1.0 ! ! These are some various commands used. ! To use you own editor instead of 'builtin', ! give the path and use %s to be substituted with ! the filename. ! DigiFAX.faxViewer: builtin DigiFAX.textEditor: builtin DigiFAX.pclViewer: xpclview %s DigiFAX.psViewer: ghostview %s DigiFAX.scanCmd: faxscan DigiFAX.kickCommand: faxsend -k DigiFAX.deleteCommand: faxsend -d ! ! When a doccument is scanned in from the 'Send Fax' ! dialog, it will be given this comment: ! DigiFAX.autoComment: Scanned in by ! ! These allow you to customize many of the default ! settings in xdigifax. ! DigiFAX*sd*noteMenu.buttonSet: 1 DigiFAX*sd*fileMenu.buttonSet: 1 DigiFAX*sd*res.buttonSet: 1 !resolution DigiFAX*sd*cover.buttonSet: 1 DigiFAX*sd*mail.buttonSet: 0 DigiFAX*sd*scan*scan_res.buttonSet: 1 DigiFAX*sd*scan*paper.buttonSet: 0 DigiFAX*sd*scan*dither.buttonSet: 0 DigiFAX*sd*scan*save.buttonSet: 1 ! ! View Dialog ! ! Zoom can be 1, 2, 3, or 4 DigiFAX.defaultZoom: 4 ! Angle can be 0, 90, 180, 270 DigiFAX.defaultAngle: 0 ! ! Recv Dialog ! DigiFAX.sendMail: 1 ! Whether to send mail, when you save a fax for someone. DigiFAX.sortTime: 1 ! Whether to list faxes sorted by time or name. DigiFAX.confirm_del: 1 ! Whether to ask to confirm deletions or not. - 4 - PN 93000173B XDigiFAX FAX System Version 1.1.0 ! If 'sendMail' is on, the following resources makeup the mail item: DigiFAX.mailMesg: An incoming fax was saved for you by %s0n %s DigiFAX.subject: Incoming fax for you ! Spool directory to use DigiFAX.recvSpoolDir: /usr/spool/fax/rx ! Command to determine what printers are available DigiFAX.printerScript: lpstat -p |grep '^printer' | awk '{print $2}' ! How often to check for new faxes (in seconds) DigiFAX.recvTimeout: 10 ! ! Stat Dialog ! ! How often to check for status changes (in seconds) DigiFAX.statTimeout: 15 THE XDIGIFAX HELP SYSTEM xdigifax has an extensive online, context sensitive help system. This system allows you to get context sensitive help from anywhere within xdigifax simply by choosing the 'Help on Context' selection from the help button at the bottom of every screen, the system will then allow you to click on any widget within the fax system, and its associated help will pop up. This system also allows you to browse through the many help pages by either clicking on a subject, or simply using the 'previous' and 'next' buttons. Clicking on the 'Help' button on the main button bar will pop up the above dialog which is the main help page. - 5 - PN 93000173B XDigiFAX FAX System Version 1.1.0 SENDING A FAX This is the dialog used to send faxes. It may be entered through several means: dropping a file into the 'send' icon, clicking on 'send' in the main menu bar, or executing the xfaxsend command from the keyboard. The dialog is split up into three main areas, the recipient pane, the files pane, and the control pane. When filling in a recipient name, the faxphone database will be perused in the following order searching for a match: 1. System wide groups 2. Personal groups 3. System wide individuals 4. Personal individuals If no match is found, xdigifax assumes that this is a temporary name, and will need a destination phone number. When an alias or a name and number is recognized it will be added to the current list of recipients. A destination may also be chosen by entering the Aliases dialog and double clicking or 'Selecting' an entry. The 'files' pane lets you choose file to use as notes and the body of the fax. These may be created on the fly if necessary by selecting the 'Edit' from the pull down menu next to the 'Notes' or 'Files' field. Only one notes file per fax is allowed, although the number of files is unlimited. The default editor used to create and edit notes and files is dtedit on UNIXware and scoedit on ODT. This default may be changed by changing the textEditor resource in your .Xdefaults file. The 'Notification' button will not work with anything other than The 'Default' setting is what ever the system administrator has set up as the system wide default. Version 2.8 of Digifax allows you to individually change the notification setting. - 6 - PN 93000173B XDigiFAX FAX System Version 1.1.0 SCANNING IMAGES Scanning is done through the 'Send' window. The 'Quick Scan' button will invoke the scanner with all default parameters (8.5 X 11 inches, high resolution), place the image in /usr/tmp, and put this tmpfile name in the 'Files' window of the 'Send' dialog box. The 'Scan' button will cause the scan dialog to popup. This window offers you the opportunity to adjust the various scanning parameters. When the window first pops up, it only displays the parameters available for FAX format scanning. When the 'Tiff format' button is pressed additional parameters relating to the tiff format are displayed as well. - 7 - PN 93000173B XDigiFAX FAX System Version 1.1.0 RECEIVING FAXES This is the dialog used to view, save, print and delete incoming and previously received faxes. Toggling the Spool directory will allow you to view the system wide incoming faxes or your personal fax directory. When you save a fax to someone else's personal directory, mail may be sent to the new owner if sendMail resource in .Xdefaults is set. The body of the mail can be set through the mailMesg resource and the subject through the 'subject' resource. MONITORING A FAX This is the dialog used to view and change various status' of the fax system. In particular this dialog lets you see the history of transmitted and received faxes, check the status of the various fax channels, as well as view and/or change various properties of faxes waiting on the transmit queue. By default the history of received and transmitted faxes is toggled off, but these and any other status window may toggled on and off from the push buttons at the top of the dialog. - 8 -