index.sgml

使用Fax Modem发送传真的程序

<!doctype linuxdoc system>

<!-- The KSendFax Handbook.

 -->

<article>

<!-- Title information -->

<title>The KSendFax Handbook
<author>J&uuml;rgen Vigna, <tt/[e-mail]/
<date>Version 0.3.1, Aug 19 1998
<abstract>This Handbook describes KSendFax Version 0.3.1

<!-- Table of contents -->
<toc>

<!-- Begin the document -->


<sect>Introduction

<p>
KSendFax is an interface to known FAX-Packages like HylaFax, E-Fax or
mgetty+sendfax for sending facsimiles. It incorporates also a phonebook
so that recipients can be saved and selected to/from this. KSendFax is
not intended to configure your whole fax-suite, but only as GUI-interface
for an already configured FAX-Package.
<p>

<p>
I hope you will enjoy this program,
<p>
<tt>J&uuml;rgen Vigna</tt>
<p>
<htmlurl url="mailto:[e-mail]" name="[e-mail]">
<p>

<sect>Installation
<p>
<sect1>How to obtain KSendFax
<p>
KSendFax hopefully becomes a core application of the KDE project
<url url="http://www.kde.org">.
KSendFax can be found on <url url="ftp://ftp.sad.it/pub/kde/local">,
and on the main ftp site of the KDE project
<url url="ftp://ftp.kde.org/pub/kde">.

<sect1>Requirements
<p>
In order to successfully compile KSendFax, you need the latest versions of
<tt> libkdecore</tt> and <tt> libkfm</tt>. All required libraries as well
as KEdit itself can be found on <url url="ftp://ftp.kde.org/pub/kde/">.

<p>
<tt> Important:</tt> You have to install a fax-package which has a sendfax
command such as HylaFax, E-Fax or mgetty+sendfax.


<sect1>Compilation and installation
<p>
In order to compile and install KSendFax on your system, type the following
in the base directory of the KSendFax distribution:
<tscreen><verb>
% ./configure
% make
% make install
</verb></tscreen>

Since KSendFax uses <tt>autoconf</tt> you should have not trouble compiling it.
Should you run into problems please report them to the <sf/KDE/ mailing lists.

<sect>Onscreen Fundamentals
<p>

KSendFax is very simply to use. You just have to fill the input-fields with
the apropriate data and then click on the <tt>Send</tt>-button. You may also
select an entry from the phonebook, which the fills the apropriate fields.

It is now also possible to send multiple files to one destination if your
fax-packages supports this. For this transfer the filename into the added
listbox. If the listbox is NOT empty all the file in the listbox are sent
to the destination. This means @@FName is substitued by the whole filelist.

You can now also view the faxqueue and remove faxes from a faxqueue.

<p>
<sect1> Key Bindings
<p>
KSendFax honors the following key bindings.


<itemize>
<item><tt/Control-P/ (De)Activate phonebook
<item><tt/Control-S/ Send Fax
<item><tt/Control-Q/ Quit Program
<item><tt/F1/        Help
</itemize>

<sect>The Menu Entries
<p>
<sect1>File
<p>
<sect2>Send Fax
<p>
Sends the Fax with the configured faxsend-command, only if at least the
file-name and fax-number are specified.
<sect2>Quit
<p>
Exits the program.
<p>


<sect1>Options
<p>
<sect2>Preferences
<p>
Allows the user to edit its preferences for various program options. For
now is the command for sending the facsimile and the file to use as phonebook.

<sect3>Send-Fax-Command
<p>
The default is here the HylaFax-command:

<tscreen>sendfax -n -h '@@Host' -c '@@Comment' -x '@@Enterprise' -d '@@Name'@'@@Phone' '@@FName'</tscreen>

Note the <tt>@@[Variables]</tt> in this command. They are substituted by:

<tscreen><bf>@@Host:</bf> ........ $FAXSERVER environment variable</tscreen>
<tscreen><bf>@@Comment:</bf> ..... input from the comment input field</tscreen>
<tscreen><bf>@@Enterprise:</bf> .. input from the enterprise input field</tscreen>
<tscreen><bf>@@Name:</bf> ........ input from the Dest. Name input field</tscreen>
<tscreen><bf>@@Phone:</bf> ....... input from the Fax-Number input field</tscreen>
<tscreen><bf>@@FName:</bf> ....... input from the File input field</tscreen>

I got positive feedback for this Fax-Packages using the following commands:

<tscreen><bf>HylaFax:</bf> sendfax -n -h '@@Host' -c '@@Comment' -x '@@Enterprise' -d '@@Name'@'@@Phone' '@@FName'</tscreen>

<tscreen><bf>mgetty+sendfax:</bf> faxspool -F 'My Name' '@@Phone' '@@FName'</tscreen>

<tscreen><bf>efax:</bf> fax send '@@Phone'  '@@FName'</tscreen>

<sect3>Show Queue-Command
<p>
The default is here the HylaFax-command:

<tscreen>faxstat -h '@@Host'</tscreen>

Note the <tt>@@[Variables]</tt> in this command. They are substituted by:

<tscreen><bf>@@Host:</bf> ........ $FAXSERVER environment variable</tscreen>

I got positive feedback for this Fax-Packages using the following commands:

<tscreen><bf>HylaFax:</bf> faxstat -h '@@Host'</tscreen>

<tscreen><bf>mgetty+sendfax:</bf> faxq</tscreen>

<tscreen><bf>efax:</bf> no feedback yet</tscreen>

<sect3>Remove job-Command
<p>
The default is here the HylaFax-command:

<tscreen>faxrm -h '@@Host' '@@ID'</tscreen>

Note the <tt>@@[Variables]</tt> in this command. They are substituted by:

<tscreen><bf>@@Host:</bf> ........ $FAXSERVER environment variable</tscreen>
<tscreen><bf>@@ID:</bf> ....... open inputbox to insert the faxid</tscreen>

I got positive feedback for this Fax-Packages using the following commands:

<tscreen><bf>HylaFax:</bf> faxrm -h '@@Host' @@ID</tscreen>

<tscreen><bf>mgetty+sendfax:</bf> faxrm @@ID</tscreen>

<tscreen><bf>efax:</bf> no feedback yet</tscreen>

<sect3>Update all n seconds:
<p>
Here you may insert an integer which tells KSendFax that the listbox
containing the Fax Queue is automatically updated ever n seconds. This
means that the command is run every n seconds and the output updated in
the listbox. If the entry is empty or <= 0 then this update is not made.

<sect3>Phonebook-File
<p>
The default is $HOME/.phonebook. The format of the phonebook-file is:
<quote>
12345678901234567890abcdefghijklmnopqrstuvwxyABCDEFGHIJKLMNOPQRSTUVWXYZ...
</quote>
It is a mainly fixed format with:

Phone-Nuber: 20 /<br>
Dest-Name: 25
Enterprise-Name: > pos(45)

<sect2>Toggle Tool-Bar
<p>
Allows the user to have the tool bar displayed or hidden.


<sect2>Hide/Show Filelist
<p>
Allows the user to have the above mentioned filelist displayed or not

<sect2>Save Options
<p>
Saves the actual choosen preferences and options.

<sect1>Help
<p>
<sect2>Help
<p>
Invokes the KDE help system with the KSendFax help pages displayed.
<sect2>About 
<p>
Displays essential information about KSendFax.

<sect>Questions and answers
<p>
<descrip>
<tag>Q:</tag> Trying to send a document will give me
              <verb>sendfax: illegal option -- c</verb>
<tag>A:</tag> Probably you are using another fax-package then the default
              HylaFax. Use Options->Preferences to set the apropriate
              fax-command for your package.
</descrip>
<p>
</article>