TkFax
Users Guide
TkFax 1.1.0.1a - A Tcl/Tk GUI for using facsimile
(c) 2001,2002,2003 Masaki Shinomiya <shino@pos.to>
Ryoji Kawagishi <kawagisi@yk.rim.or.jp>
TkFax 0.91 (c) 1998 Hang Bae Kim <hbkim@muon.kaist.ac.kr>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.
Contents
1. Making fax pages
2. Sending fax
3. Using the Phone Book
4. Queuing outgoing faxes
5. Recieving fax
6. Looking up faxes
7. About this version
8. Bug and report
================================================================
1. Making fax pages
================================================================
The procedure will be:
(1) Input the recepient
(2) Making the cover page
(3) Making pages from text or image files
(4) Using a scanner
(5) Preparing and checking pages
(1) Input the recepient
Input the fax Number and Recipient.
See the later how to use the Phone Book.
(2) Making the cover page
Select the template from 'English', 'Japanese'(*), 'Aux'(*).
This button places at the top right in the Page Manipulation group.
Then, click 'Cover'. Making Fax cover page window will appear.
See the Help in the Making Fax cover page window. Edit the entries.
Click 'Complete'. The cover page will be automatically created.
After a few second, you can find the name such as 'cvr01234.001.g3'
in the Page List.
You can check the page by double clicking this name or use 'View'.
*) You can use 'Japanese' only when your system can treat Japanese.
*) Prepare the TeX macro for 'Aux' by name 'covermacro-aux.tex'
at the directory, usually at '/usr/local/lib/tkscanfax1/tex'(system)
or at '~/.tkfax1/tex'(user).
If you are familiar with TeX, you can customize the file 'covermacro-??.tex'
at the system directory, usually at '/usr/local/lib/tkscanfax1/tex'
or copy it in the user directory, '~/.tkfax1/tex'.
(3) Making pages from text or image files
Click 'File', select the file you want to attach. Sometime you must
also select the type of the file.
You can select multiple files at a time. Try dragging, Shift-key+clicking,
Ctrl-key+clicking, and see how the actions effect.
Click 'Attach'. The page will be created and add on the Page List.
(4) Using a scanner
Click 'Scan'. The TkScan window will appear.
See the Help in the TkScan window.
(5) Preparing and checking pages
Select the file name in the Page List and click 'View',
the fax viewer will be launched. Or simply double-click the file name.
Click 'View All' to see all the pages listed in the Page List
if your viewer supports this function. Kfax supports 'View All'.
Check the page order. Use Up and Down to change the order.
You can 'Delete' pages you do not want to send.
==================================================================
2. Sending fax
==================================================================
(1) Fill the fax 'Number' and the 'Recipient' at Dialing & Queuing.
(2) You can 'Regist' the 'Number' and the 'Recipient'
to be registered in the Phone Book for the later use.
(3) Click 'SEND' to send the fax pages on the Page List.
If you have a phone connected with the modem and use the phone in dialing,
skip the process (1)to(2). Confirm the receiver ready and just click 'SEND'.
Then put down the handset.
If you have already recieved a call by the phone and the line connected,
you can click 'SEND' to send fax. Put down the handset.
If you check the 'Fax Spool' box on, the fax data will be handed to
the spooler and sent in the background. You can check the status with
looking up the 'Fax Outgoing'.
If you like to use 'Fax Spool' function with efax, you need
efax-0.9a001114a6 or later, and to see the documents.
==================================================================
3. Using the Phone Book
==================================================================
Click 'Phone Book' on the TkFax main window. The Phone Book
window will appear.
(1) Making a new Group
Fill the 'Group Name' entry by the name of the new Group.
Use the 'Description' entry to describe the summary of the Group.
Click 'Add', then the new Group added on the Group list.
(2) Add a new address
Fill the entries, 'Fax Number','Recipient','Organization','Description',
on the lower part of the window.
Select the Group, which the new address to be the member of
from the upper part of the window. The Group 'All' is the exception.
Click 'Add' on the lower part of the window.
From the main panel, click 'Regist' to register the Number and Recipient.
This entry is add in the 'Misc' Group.
(3) Use a registered address
Select the Group from the Group list on the upper part of the window.
When All is selected, all address of all Group is showed on the lower part.
Select a Fax Number in the list on the lower part, then the entry is showed
in the lower columns.
Click 'Select Fax Number', then the Fax Number and the Recipient are
sent to the main panel.
If you have opened the Making Fax cover page window, the Fax Number,
Recipient, Organization and Description are sent to the Making Fax cover page.
==================================================================
4. Queuing outgoing faxes
==================================================================
You need settings to work the spooling if you use 'efax' as the fax agent.
See 'SENDING FAXES USING THE PRINT SPOOLER' section of 'man efax'.
We recommend 'efax' with 'efax-spooling.patch'. Otherwise, Fax Received
and Fax Outgoing Directory should be the same as the Fax Directory.
Check the Fax Spool 'Spooling' to enable this function. In this mode,
terminal window does not apear when you click 'SEND' button. Faxes are
put in the 'Fax Outgoing' box, and sent automatically by the background
program. You need not wait until the sending action finished in this mode.
Dialing is retried if the line was busy. The interval and how many times of
retrying is set by /etc/efax.rc. A mail will be sent to the user when the sending
job is completed and when failed after the max times of retry.
Sending jobs in the queue can be look up by clicking the 'Fax Outgoing' button.
Use 'Delete' button after selecting jobs to abort sending, .
The 'Fax Outgoing' box can also manipulate any fax jobs using the print spooler
other than by TkFax.
The headers in fax queue window does not properly indicate in case using efax.
NOTE: Settings in ~/.efaxrc do not affect in this mode.
==================================================================
5. Receiving fax mannually ( efax only )
==================================================================
This function does not work with 'sendfax' as the fax agent.
A phone to be connected with the modem.
(1) Hook up with TkFax
When you have a fax call and the bell of the phone ringing,
Click 'RECEIVE' on the main panel.
The modem will hook up, receive the fax, and automatically hook down.
(2) Hook up with the phone
Ask the receiver to be ready. Confirm the tone of the fax machine.
Click 'RECEIVE' on the main panel. Put down the handset.
(3) Dial up and receive fax
Dial up with the phone. Confirm the sender ready.
Click 'RECEIVE' on the main panel. Put down the handset.
==================================================================
6. Looking up faxes received
==================================================================
Click 'Fax Received'. The Fax Received window will appear.
Select faxes from the Received Fax List and click the command.
You can View, Save, Print, Delete, or Attach.
The 'Attach' command makes a copy of the fax page in the Page List
on the main panel so that you can pass this copy to another recipients.
==================================================================
7. About this version
==================================================================
TkFax 0.91 is written by Hang-Bae Kim as a Tcl/Tk GUI for sending and
receiving faxes with mgetty+sendfax.
TkFax 1.1.0_20021222 is to work with efax, that supports Class 1, 2 or 2.0 fax modems.
This version can treat Japanese characters and potentially allows any languages
if you prepare the enviroments properly.
GUI in this version is extended including making cover page and configuring the
settings.
Some new scanner drivers added in this version.
Documantations prepared and maintained.
==================================================================
8. Bugs and report
==================================================================
Do not hesitate to contact us. Please e-mail to: tkscanfax <shino@pos.to>
The supporting page at the URL: http://shino.pos.to/linux/tkscanfax.html
==================================================================
History
Oct 1998 version 0.91 by Hang Bae Kim <hbkim@muon.kaist.ac.kr>
(Stable)
May 2001 I18N and efax extention project starts
Jul 2001 version 0.99
Jan 2002 version 1.0
(Current)
Jan 2003 version 1.1.0
TkScanFax extention project
Masaki SHINOMIYA <shino@pos.to>
Ryoji Kawagishi <kawagisi@yk.rim.or.jp>