5 Configuration (Preferences Menu and Wizard)
Keywords: ksendfax

Next: 6 ToDo Up: The KSendFax Handbook Previous: 4 The Menu Entries Contents
Subsections

- 5.1 Fax Options
  - 5.1.1 Send-Fax-Command
  - 5.1.2 Show Queue-Command
  - 5.1.3 Remove job-Command
  - 5.1.4 Cover Page
  - 5.1.5 Update all n seconds:
  - 5.1.6 Convert to Postscript before sending documents
- 5.2 Special Fax Options
  - 5.2.1 Exclude this mime types from postscript convert
  - 5.2.2 Always convert this mime types to postscript
- 5.3 Personal Data
  - 5.3.1 Name
  - 5.3.2 Company
  - 5.3.3 Number
- 5.4 Scanner Options
  - 5.4.1 Image Type
  - 5.4.2 Use external scan program
  - 5.4.3 Command
- 5.5 Phonebook Options
  - 5.5.1 Selection of the phonebook you want to use
  - 5.5.2 File
- 5.6 Misc Options
  - 5.6.1 Log Directory
  - 5.6.2 Preview Command
  - 5.6.3 Date Format
  - 5.6.4 Convert Command
- 5.7 Filters to Postscript

#
5 Configuration (Preferences Menu and Wizard)

## 5.1 Fax Options

### 5.1.1 Send-Fax-Command

The default is here the HylaFax-command:

  sendfax -n -h '@@Host' -c '@@Comment' -x '@@Enterprise' -d '@@Name'@'@@Phone' '@@FName'

Note the @@[Variables] in this command. They are substituted by:

@@Host | ... | $FAXSERVER environment variable
@@Comment | ... | input from the comment input field
@@Enterprise | ... | input from the enterprise input field
@@Name | ... | input from the Dest. Name input field
@@Phone | ... | input from the Fax-Number input field
@@FName | ... | input from the File input field
@@FromName | ... | input from the Personal->Name input field
@@Regarding | ... | input from the Regarding input field

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

HylaFax:
  sendfax -n -h '@@Host' -r '@@Regarding' -c '@@Comment' -x '@@Enterprise' -d '@@Name'@'@@Phone' '@@FName'
mgetty+sendfax:
  faxspool -F 'My Name' '@@Phone' '@@FName'
efax:
  fax send '@@Phone' '@@FName'

### 5.1.2 Show Queue-Command

The default is here the HylaFax-command:

  faxstat -h '@@Host'

Note the @@[Variables] in this command. They are substituted by:

@@Host | ... | $FAXSERVER environment variable

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

HylaFax:
  faxstat -h '@@Host'
mgetty+sendfax:
  faxq
efax:
  no feedback yet

### 5.1.3 Remove job-Command

The default is here the HylaFax-command:

  faxrm -h '@@Host' '@@ID'

Note the @@[Variables] in this command. They are substituted by:

@@Host | ... | $FAXSERVER environment variable
@@ID | ... | open inputbox to insert the faxid

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

HylaFax:
  faxrm -h '@@Host' @@ID
mgetty+sendfax:
  faxrm @@ID
efax:
  no feedback yet

### 5.1.4 Cover Page

Here you may choose between the buildin coverpage feature of your fax package, which is reflected in the call to you send-fax command, or a file you have in the coverpages directory of your system ksendfax application directory $KDEDIR/share/apps/ksendfax or in your personal kde application directory /.kde/share/apps/ksendfax. If you see there listed all files from your home directory then both of the directories are missing, which points to a wrong installation!

This variables are substitued in the cover page, BEFORE transforming it to postscript (if it is not already in postscript format):

@@Comment | ... | input from the comment input field
@@Enterprise | ... | input from the enterprise input field
@@Name | ... | input from the Dest. Name input field
@@Phone | ... | input from the Fax-Number input field
@@Date | ... | the actual date in the specified format
@@FromName | ... | input from the Personal->Name input field
@@FromPhone | ... | input from the Personal->Fax number field
@@FromEnterprise | ... | input from the Personal->Enterprise field
@@Regarding | ... | input from the Regarding input field
@@Pages | ... | the number of pages excluding the coverpage

### 5.1.5 Update all n seconds:

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.

###
5.1.6 Convert to Postscript before sending documents

If this is on then all documents are transformed to Postscript (if not already) using the filters you defined.

## 5.2 Special Fax Options

This special options regard the forced transformation to postscript of the documents you want to send 5.1.6. Be aware that all this postscript convert stuff needs a defined filter to work!

### 5.2.1 Exclude this mime types from postscript convert

Checking this and inserting certain mime types in the below listbox you can exclude them from being converted to Postscript. This is usefull if you know that your faxsend program can handle this mimetypes and so it is not needed that they are converted to Postscript.

### 5.2.2 Always convert this mime types to postscript

Checking this and inserting certain mime types in the below listbox forces the program to always convert this types to postscript also if it normally should not. This can be used f.ex. for troff files which have to be converted before sent otherwise all the format commands in the textfile are sent too.

## 5.3 Personal Data

This Data is needed to be substitude by the @@ variables in the send fax command (see: 5.1.1).

### 5.3.1 Name

The Name you want be substitued as @@FromName.

### 5.3.2 Company

The string is substituted as @@FromCompany.

### 5.3.3 Number

The string is substituted as @@FromFax.

## 5.4 Scanner Options

### 5.4.1 Image Type

Here you define which default image type you want to use for scanning. This is directly used for the buildin scan support. For the external scan program the extension .tiff or .ps is added to the filename (see: 5.4.3).

### 5.4.2 Use external scan program

Calls the command inputed in the below Command: input box or if that is empty as default ``xsane -N @@FName'' is called.

### 5.4.3 Command

Input here the command you want to call to scan your fax page(s). You can insert the @@FName variable in this command and this will be substitued by a fixed filename which is composed of ``page_1.'' and the above defined extension tiff or ps.

## 5.5 Phonebook Options

The format of the buildin phonebook-file is:

  12345678901234567890abcdefghijklmnopqrstuvwxyABCDEFGHIJKLMNOPQRSTUVWXYZ...

It is a mainly fixed format with:

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

### 5.5.1 Selection of the phonebook you want to use

With this you may select what you want to use as phonebook, you may select from:

- Use KSendFax phonebook: This uses the buildin phonebook.
- Use KAddressBook: This uses the program kaddressbook which is now the default addressbook program for KDE.

### 5.5.2 File

The default is $HOME/.phonebook.

## 5.6 Misc Options

### 5.6.1 Log Directory

Give the absolute path to the directory you want to use as log directory. The default is the log directory used for KDE (normally /tmp/kde-$USER).

### 5.6.2 Preview Command

The command you want to use to view the preview. The preview is done ONLY in Postscript so this should be a postscript viewer command. You have to insert the @@FName variable which is substitued by the filename which is being previewed. The default is: gv @@FName.

### 5.6.3 Date Format

Here you insert the output format of the @@Date in the coverpage. For the format options see the format options of the date command (man date).

### 5.6.4 Convert Command

This command is used to concatenate multiple files to one big postscript file. The default is set to ``convert @@FName @@TmpFName'', where @@FName is substitued with the list of files you want to send, plus an eventual cover-page, and @@TmpFName is substitued by a temporary filename, which is the output filename. This command is used ONLY by the preview feature and the @@TmpFName is deleted after the preview program has exited. This also means that the command can input all possible type of files (depending on your configuration of filters!) and has to output a Postscript file. @@TmpFName will always end with a .ps extension.

## 5.7 Filters to Postscript

In this dialog you may enter, edit or remove filters for certain mime types to postscript. @@FName is substitued by the original filename and @@OutFName it substitued by the output file name. Both HAVE to be specified in the command to have any effect!

Next: 6 ToDo Up: The KSendFax Handbook Previous: 4 The Menu Entries Contents