
	Release Notes for FaxIt 2.4
	===========================



1.      INSTALLATION
	1.1 File Contents
	1.2 Installing FaxIt
	1.3 File Structure
	1.4 Start FaxIt for the First Time
	1.5 Upgrading from Previous Versions

2.      CONFIGURATION
	2.1 Setting up the Printer Driver
	2.2 Cabling
	2.3 Fax Modems
	2.4 Troubleshooting Modems
	2.5 FaxIt Settings

3.      USING FAXIT
	3.1 How to Fax a Document
	3.2 The FaxIt Main Screen
	3.3 The Fax Details Window
	3.4 The Diamond Menu
	3.5 The Coversheet Editor
	
4.      SYSTEM CONSIDERATIONS
	4.1 Disk Space
	4.2 System Performance

5.      LEGAL DEPARTMENT
	5.1 Shareware
	5.2 Terms and Conditions
	5.3 Acknowledgements

6.      SUPPORT
	6.1 Support
	6.2 History


==================================================

1.      INSTALLATION

1.1 File Contents
-----------------

The file FAXIT23.ZIP should contain the following files:


        SETUP.OPO       (Setup installation program)
        FAXIT.CTL       (FaxIt Setup control file)
        COVERS.CTL      (Coversheets Setup control file)

	FAXIT.OPA
	FAXIT.BIN
	FAXIT.RSC
	C2.DRV
	SHEET.OVL
	P_FAXIT.WDR
	COVER1.CVS      (Sample coversheet file)
	COVER2.CVS       .      .
	COVER3.CVS       .      .
	UPGRADE.TXT     (Notes for upgraders)
	README.TXT      (this file)

Refer to one of the following 2 sections depending on how you will be
copying the files to your Psion. Once the files have been copied across,
continue with section 1.5, Completing the Installation.


1.2 Installing FaxIt
--------------------

You can use FaxIt's Setup program if a) you have unzipped the files
onto your Psion directly, or b) as long as you can establish a 'Link'
to another computer. In most cases, this means connecting to a PC
running PsiWin 2, PsiWin 1, RCOM or MCLINK. It should also work
with connections to PsiWin for Macintosh, or indeed anything which
can appear as remote drives (REM::) from the Psion 3a/3c.

If you are using a remote computer, firstly, set up the link. Connect
up the 3-Link cable, start the link on the host, and start Link on
the Psion (Psion-L).

Copy the program SETUP.OPO from where the FaxIt files are located to
the \OPO directory on any drive on your 3a/3c. How you do this will
depend on the Link software you are using. If you are using PsiWin,
remember to just 'Copy' the file and not 'Copy and Convert' it.
'Setup' should now appear under the RunOpo icon on your system screen.

Next, run 'Setup'. It will prompt you for a .CTL filename. Press <tab>
then browse to locate the FaxIt files where you will find FAXIT.CTL. 
Select this file and press <RETURN>. Follow the directions of the Setup
program. The only decision you need to make is which Drive to install
the programs into. FaxIt is suitable for installation on Flash memory.


Installing Coversheets

FaxIt requires a data directory to keep day to day files in. This
is normally \FAXIT and may also be on any drive, even a different 
drive to the programs. It is not suitable for Flash memory however.
The sample coversheets supplied with FaxIt should be put into this
data directory. To install the coversheets into this directory, use
the Setup program to browse to where you Unzipped the FaxIt files
and select COVERS.CTL as the file. You can then select the Data drive
to install them to.


1.3 File Structure
------------------

You may wish to install the files manually. In this case, they should
finish up in the following structure:
Drive x: is the program drive (may be Flash RAM)
Drive y: is the data drive (preferably not Flash RAM)
x: and y: may be the same drive.

x:\ + APP
    .  |
    .  + FAXIT
    .  .   |
    .  .   + faxit.bin
    .  .   + sheet.ovl
    .  .   + c2.drv
    .  .   + faxit.rsc		(optional)
    .  .
    .  + faxit.opa
    .
    + WDR
    .  |
    .  + p_faxit.wdr
    .

y:\ + FAXIT
	|
	+ cover1.cvs		(optional)
	+ cover2.cvs		.
	+ cover3.cvs		.


1.4 Starting FaxIt for the First Time
-------------------------------------

Install FAXIT.OPA with the standard Psion-I.

The first time you run FaxIt, if you did not install the sample
coversheets, you will be prompted for the drive
on which to install data files. A directory call \FAXIT will be
created on this drive. Due to the volatile nature of the fax
queue, it is preferable that this not be a Flash SSD.



1.5 Upgrading from Previous Versions of FaxIt
---------------------------------------------

At present, FaxIt can not upgrade Fax files or Queue files from
previous versions. If you currently have version 1.4 or earlier,
you should delete the \FAXIT directory and its contents before
running FaxIt 2.4 so that it will create a new directory and new
datafiles from scratch.


2. CONFIGURATION

2.1 Setting up the Printer Driver
---------------------------------

FaxIt works by periodically looking for a print file called FAX.LIS
in the \FAXIT data directory. It then renames it out of the way while it
is being processed. The easiest way to make this happen is to configure
the printer destination. From the System screen, select Psion-Y. Change
the printer device to <File>, the File Name to \FAXIT\FAX.LIS. Change the
File Disk to the drive where you created the \FAXIT data directory. This
changes the default printer destination for all applications. Even if you
change it back to <Serial> or <Parallel>, it will still remember the Disk
and File Name should you change it back to <File> again later.

You will probably print more than you fax, so it makes sense
to leave the default printer as Serial or Parallel. You can then
change the printer destination temporarily from the Printer Setup
of each application (Psion-Y) each time you want to send a fax.
This sounds more complicated than it really is.


2.2 Cabling
-----------

To connect a fax modem to the Psion, you will need the Psion 3-Link cable
and a modem adaptor cable. The modem adaptor cable is normally available
from stockists of 3-Link. Alternatively, you can make a simple converter
to change the signals from the 3-Link serial cable to those required for
your modem. The following cables work in most cases, although you should
check your modem manual if you are in any doubt.

		3-Link (25pin)  Modem
		======          =====

		2  -------------  3
		3  -------------  2
		4  -------------  5
		5  -------------  4
		7  -------------  7
		6  -------------  20
		20 -------------  6


		3-Link (9-pin)  Modem
		======          =====

		2  -------------  3
		3  -------------  2
		7  -------------  8
		8  -------------  7
		5  -------------  5
		6  -------------  4
		4  -------------  6


2.3 Fax Modems
--------------

The following table is based on feedback from users. If a
modem is shown as "Not Class 2" then it will not work with FaxIt.
Please let me know if it works with your modem, and just as importantly,
let me know if it doesn't and I'll see what I can do (providing your
modem does claim to be Class 2 or 2.0 compatible that is).


AIWA WorldComm PV-PFV144 (portable) 
Andest Roadrunner 14.4 (portable) 
ASCOM AM2496F 
Boca Modem 14400
Cray Quantum 144 				(Not Class 2)
Dayna CommuniCard 14400
Dynalink 1414VQP (portable) 
Eigercom 33.6 PCMCIA
Ericsson 318/DC12 data card (cellular)
Ericsson GS18					(Not Class 2)
ELSA Microlink 28.8 TQV
ELSA Microlink 33.6 TQV
Express 14.4e
GVC 28800 External
GVC 24/96 Pocket
Hayes Accura 144 +Fax	
Hayes Optima VFC+FAX 28800  			(Not Class 2)
Infotel 1414VQP (portable)
Megahertz PCMCIA CC3288
Microcom Deskport 28800
Microcomputer Research Inc. "Mr Modem"  	(Not Class 2)
Microfax 14.4
Motorola Lifestyle 28.8  			(Not Class 2)
Motorola Online 28.8     			(Not Class 2)
Multitech MT1932ZDXK
Multitech MT2834BLKV
New Media Netsurfer 33.6 (cellular)
Nokia 2110/Data card (cellular)
Nokia 9000
Novafax 28800
Nuvotel Voyager 96424PFX  			(Not Class 2)
Olitec Fax/Modem 14400
Olitec 28800
Pace Linnet 34fx
Pace Microlin FX32+ (portable)
Pace Microlin fx34 (portable)
Pace Mobifax  					(Not Class 2)
Panasonic EB-PA400 GSM Data Card PCMCIA
Practical Peripherals 14.4 
Practical Peripherals PM288MT
Psion Dacom Gold Card Classic (C2 landline, only C1 GSM)
Psion Dacom Gold Card Global (56k Class 2 GSM only, V34 GSM and Landline)
Psion Dacom Surfer
Psion Travel Modem
Racal ALM3226 (portable)
Repko SL-144.1F
SupraFAXModem 14.4
Trust 28800/14400 Data/Fax
Twincom 14.4
UCOM Nordic 14400
US Robotics 56k x 2 Voice Modem
US Robotics Courier V.32bis Terbo
US Robotics Courier Dual Standard V34 
US Robotics Sportster 14400 Vi  		(Not Class 2)
US Robotics Sportster 28800
US Robotics Sportster Vi 28800
US Robotics Worldport 14400 & below  		(Mostly Not Class 2, but newer ones are C2.0)
US Robotics Worldport Dual Standard Cellular
Viva 2496P Pocket Fax
Zoltrix ZX-144  				(Not Class 2)
Zoom PKT 144 (portable)
Zoom V.34XE 28.8
Zyxel U-1496 E+
Zyxel 2864 Elite


An up to date list of working (and non-working) modems can be found 
at the FaxIt Web site. See "Support" below for details.


2.4 Troubleshooting Modems
--------------------------
	
There are two things you can do if you are having problems with your fax
modem. Firstly, run "Query Modem" (Psion-Y). This opens the serial port,
initialises the fax modem, then tests it for Class 2/2.0 compatibility.
If this works you should be able to fax successfully with this modem.
If not, try changing the "DSR handshaking" setting in the Modem
Settings screen (Psion-M). Modems normally work with this set to "No",
however the Psion Travel Modem needs this set to "Yes".

For more detailed diagnostics, select "Trace On" (Psion-T), then
attempt to send a fax. This creates a file "FAXDUMP" in the \FAXIT
data directory which will contain a trace of the conversation between
FaxIt and the modem. This file should be plain text, and can be
viewed or printed. If you cannot persuade your modem to work, e-mail
me this file and I will try to find out why FaxIt is having a problem.
The FAXDUMP file is cleared with each fax attempt so it will only
ever contain a trace of the last attempt (or the last Query
Modem attempt). Psion-T will toggle the Trace setting to "Off".
This setting is not saved when you exit FaxIt so Trace will always be
set to "Off" when you start up FaxIt.


2.5 FaxIt Settings
------------------

Preferences (Psion-Q):

	Automatic Foreground

		Set to <Yes> to jump to foreground when a
		fax print file is found

	Delete Completed Items

		Set to <Yes> to automatically delete Faxes
		after they have been sent successfully. Set to 
		<No> to leave them on the queue with a time of 
		"Defer".

	Maintain Log

		If set to <Yes> FaxIt will maintain a list of
		completed faxes (successes and failures)
		in the file "Faxlog" in the \FAXIT
		directory. This is a plain text file which you
		can view from FaxIt

	Phonecard Prefix / Suffix

		If you use a phone charge card, enter the
		number here. Some cards require both a prefix and a
		suffix, others use just a prefix. You can select
		whether to use the card on a fax by fax basis.

	Close Phonebook After Use

		FaxIt can use a phonebook to store fax numbers.
		It is just a Data application. If this field is set to
		<Yes>, the Data App is closed after each use to conserve
		memory. Set it to <No> to leave the Data App running. Note
		that this only applies if FaxIt launches the phonebook. If
		it was already running it will not be closed after use.

	Phonebook Name

		Use <tab> to select a Data file to use as
		a Phonebook. This must be an existing Database file.
		To create a blank one, use the Data Application then select
		it from here.



Port/Modem Settings (Psion-M):

	Port Settings
	-------------

	Modem Port

		Indicates the TTY: device. Set to "A" on a Psion 3a
		or 3c.

	Port Open Delay

		Set to the number of seconds to wait after opening the
		serial port before sending any characters. This should
		be set to a higher value for GSM data card modems which
		often use the port open action to turn on the modem. This
		can result in several seconds delay before the modem is ready
		to receive commands. Some pocket modems will benefit from
		a higher value too.

	DSR handshaking
		Normally set to "No" works with most modems. Set to "Yes"
		for the Psion Travel Modem.


	Modem Settings
	--------------

	Modem is initially

		<Enabled> or <Disabled>. Set the default state
		of the modem when you start FaxIt.

	Modem Initialisation String

		The initialisation string to send to your fax modem
		before each fax call. FaxIt sets any modem settings
		which are important so normally you will not
		need to put anything special in here. It is
		best left as "ATZ" which just resets the modem.

	Maximum Speed

		Defaults to 14400 but you can set this to a slower
		speed if you experience recurring communication errors.

	Dial Modifier

		The part of the dial string which must
		immediately follow the "ATD" command. Use
		"T" or "D" to force Tone or Pulse dialling.

	Maximum Line Errors

		This is the limit of *Error* attempts that
		FaxIt is allowed before giving up. When 
		exceeded, a fax stays on the queue with a
		send time of <Defer> until the problem is
		fixed or the fax is deleted. Note that an
		*Error* is defined as a communications
		error such as being cut off, the call
		is answered but not by a fax machine,
		or no answer at all. Line engaged is
		*Not* an Error.

	Retry Period

		The number of minutes that FaxIt should
		wait before retrying a fax transmission.


Coversheet Fields (Psion-S):

	
	Fax Number

		Your fax number. This is sent to the
		receiving fax machine for identification and also
		appears in the header line of outgoing faxes and on
		coversheets if required.

	Name / Organisation

		Enter your name and organisation as you wish them to
		appear on coversheets. Note that these fields can be
		over-ridden on a fax by fax basis.

	Default Coversheet Name

		Select a file to be the default coversheet for new
		faxes. This can be changed on a fax by fax basis.


3. USING FAXIT

3.1 How to Fax a Document
-------------------------

To fax a document from say, the Word application, it is best to select 
fax output before you start typing, as this sets up the fonts you can use
in the document. If you want to fax an existing file, setting the printer 
destination to FaxIt will convert your existing fonts to their nearest
equivalents. To select FaxIt as the destination printer:

	Select Printer Configuration (Psion-Y)

	Press <tab> on Printer model and set it to "FaxIt 2.2"

	Press <tab> on Printer device and change Printer device to "File"

	Set File: Name to "\FAXIT\FAX.LIS" and Disk to point to whatever
		you set your FaxIt data drive to be (Internal/A/B)
		(This is the bit you don't have to do every time if
		you have set it up in the System screen (above) ).

Once you have selected FaxIt as the destination printer, the
following fonts are available within your document:

Times (9 & 13 point), Helvetica (9 & 13 point) and Courier 7 point

The text can be made Bold, Underlined or Italic (Italic is faxed
as reversed text,ie white on black, not sloping text).
Because FaxIt uses a printer model, *any* 3a/3c application should
be able to send faxes, as well as being able to use the standard
Print Preview facility.


FaxIt only moves the FAX.LIS file out of the way once you
have entered a fax number for it. It makes sense to do this
immediately after printing to avoid the print file being 
overwritten. You can set FaxIt to automatically jump to
the foreground and prompt for a number as soon as it finds a
print file. This is the default behaviour. Once you have entered
the fax number (and any other details) the file is saved and
queued for transmission. It is then safe to print anything else
to the fax print file.

FaxIt can be interrupted at most stages during call placement.
Press "Esc" and FaxIt will cancel its present activity and return
control to the user at the next convenient stage.



3.2 The FaxIt Main Screen
-------------------------

The FaxIt screen looks largely like a spreadsheet screen. Each
row is a queued fax which may or may not be eligible to be sent
now. Up, Down, PgUp and PgDn move the selection box a single
item or a page at a time. Home and End go to the top or bottom
of the queue respectively. When a fax is highlighted, the
following actions may be performed:

Del     -       Delete this item. You will be asked for confirmation.

Enter or
Psion-V -	View the fax fields in more detail.

Psion-N -       Send Now, regardless of the time it is queued for

Psion-D -       Defer. This fax will remain on the queue but
		will not be sent until specifically changed.
		Useful for queuing up faxes when you don't have
		access to the modem or a phone line for example.

Psion-C -       Change the settings using the Fax Details window
		described below.


The Columns of the screen should be largely self explanatory.
The Status column is the status of the *last* transmission
attempt. If blank, no attempt has been made yet. The T/E column
refers to Tries/Errors. Tries is the number of attempts made
to send it, Errors is the number of communication failures. This
increases until the limit set in Preferences is reached. An
engaged number increments the Tries count but not the Error count.


3.3 The Fax Details Window
--------------------------

This screen will be presented whenever FaxIt has found a print
file to be faxed, or when you change the details of a fax
(see below).

Fax Number      -       The fax number. Note that you can use the
			<P> button to call up your phonebook if you
			have one set up. Highlight the fax number in
			the Data App then return to FaxIt (Shift-System
			will achieve this). Then usr the <B> button to
			bring the fax number into FaxIt. This will also work
			from any other application which supports Bring.

			Note also that you can specify fax numbers using
			the Psion Country Suffix, e.g 0123 456789[France].
			This is translated automatica;;y and the resulting
			number is shown on the next screen for further editing
			if required.

Use Phonecard	-	Set to <Yes> to prefix the number with the phonecard
			number set up in the Preferences Screen. Note that
			the phonecard number will not show in the FaxIt screen
			but will be used when the number is actually dialled.

Send Time       -       Set to <Now>, <Defer> (never, unless changed)
			or <Specify> to set an actual Date/Time.

With Coversheet -	Set to <Yes> to include a simple user-designable
			coverpage on the front of your fax.


Fax Details Second Screen:
Note that this screen differs depending whether or not a coversheet
has been specified.

Fax Number	-	The translated fax number (see previous screen)
	
Reference       -       A reference for you to recognise this
			fax on the Queue



The following fields can be entered when a coversheet has been
selected.

Attention Of	-	The intended fax recipient

Organisation	-	and their company name

From    	-       Your name.

My Organisation	-	Your company name

Coversheet Name	-	Filename of a coversheet file to use
			(*.cvs)



3.4 The Diamond Menu
--------------------

Psion-plus (+) enables the fax modem in Direct Dial mode.
Psion-star (*) enables the modem in Dial-Out mode. It will prefix
	fax numbers with the Dial-Out string set up in the System
	Dialling dialogue (Shift-Psion-D).
Psion-minus (-) disables the modem.

Alternatively the Diamond Key toggles between the three states.



3.5 The Coversheet Editor
-------------------------

You can create new Coversheets (Psion-W) or edit existing ones (Psion-E).
Coversheets must reside in the \FAXIT data directory and have a file type
of .CVS

The editor is fairly simplistic and straightforward. All coversheets
use the Courier 7 font. You can also set a bold font by inserting ~B
at the beginning of a line. Note that the bold attribute will apply to
the entire paragraph, i.e. up to the next <return>. A second ~B will
revert to normal font. You can embed 'tags' which will be replaced by
the appropriate fields when the coversheet is faxed (see menu).

A coversheet can be up to 2048 characters long.



4. SYSTEM CONSIDERATIONS

4.1 Disk Space
--------------

The application itself is not very large. Queued faxes are small too,
so queuing up a batch of faxes does not take up an undue amount of space.
Conversion of the queued fax into a format for transmission can be quite
disk hungry however, and can be anything from 10k to 30k per page
depending on content. Be aware of this when faxing large documents.


4.2 System Performance
----------------------

Sending a fax to a Group 3 fax machine involves blasting the data down
the serial port to your fax modem at 19,200 baud. The fax protocol does
not allow for interrupts in transmission, meaning that if ever the modem
runs out of data (perhaps because the Psion is doing something else) the
fax call will drop and will have to be started over. Task switching
while a fax is being transmitted, lowers FaxIt's priority to below the
task you switched to. The call will *probably* drop although this does
depend on what you switched to, and how much buffer memory your
fax modem has. To be absolutely safe, do not task switch while
a fax is being sent.



5. LEGAL DEPARTMENT

5.1 Shareware
-------------

FaxIt is Shareware. An unregistered version is fully functional, except
that it is limited to sending one page. This restriction can be lifted
by sending 14UKP (US$25) to the address below, or on Compuserve, GO SWREG
to access the Shareware Registration service. FaxIt's Registration ID is
8639. You will then be sent a registration code. You may use the software
for 30 days for evaluation purposes after which you must either register
it, or remove it from your machine.



5.2 Terms and Conditions
------------------------

FaxIt may be distributed freely providing that a) it is not modified in
any way, and b) that this notice forms part of the distribution.

Reverse engineering of any component of FaxIt is
expressly forbidden.

The author and distributors of this software can not be held liable for
any damage or loss of data either directly or indirectly, arising from
the use of FaxIt. No warranty is either expressed or implied.


5.3 Acknowledgements
--------------------
"Psion Setup  (c) is  written  by Jochen  Siegenthaler and  used  under
licence." You can find information about SETUP as well as other useful
Psion software at Jochen's Website:
http://ourworld.compuserve.com/homepages/JochenSiegenthaler

6. SUPPORT

6.1 Support
-----------

A Web page has been created to provide up to the minute information
about FaxIt. A list of compatible modems is maintained, as well as facts
and fixes for support issues. News about upgrades and up and coming
features and a few screen shots are also maintained here too.
Alternatively, I can be contacted by e-mail or letter post at the
addresses given below.

The Web page URL is given at the bottom of this document.

Please let me know if you find things in FaxIt that don't work
as advertised. That way the software gets fixed sooner. I am also
keen to receive feedback about modems which work, and those which
don't.


6.2 History
-----------

1.1
	First Release
1.2
	Fix multi-page problem
1.3
	Introduced modem test facility (Psion-Y)
	Longer timeouts allowed during initialisation phase
	Copes with modems that supply remote CSI without quotes
	Trace facility (Psion-T).
	Internal event handling rewritten
1.4
	Fixes another multi-page problem
	Fixes bug which (very rarely) misses a line from the fax
	Handles non Class 2 modems
	Quits tidily if page is wider than faxpaper size

2.0a
	Simple Coversheets
	Phonebook facility
	Ability to 'Bring' fax numbers
	Supports Country suffixes in fax numbers
	Supports phone Chargecard
	Supports System Dial-Out prefix
	New View Details Screen (Enter or Psion-V)
	Delayed port open (helps Data Card Modems)
	Adds DSR flow-control (for Psion Travel Modem)
	Additional support for Multitech Fax Modems
	Can limit fax transmission speed (some modems struggle
		to fax successfully at 14400)

2.0b
	Completed Help file
	Expanded phonecard number to have Prefix & Suffix
	Added option to 'Read Text file' in coversheet editor

2.1
	Small modification to 'View' screen

2.2
	Added DSR handshaking flag

2.3
	Changed Help system to use rsc files
	Added context-sensitive help
	Alter field order in Fax Settings screen
	Fixed problem with StatusWindow settings
	Fixed problem with duplicate pages in registered version

2.4
	Change of Address in About screen, otherwise functionally
	identical to 2.3


Walter Wright
3, Butts Hill Road
Woodley
Reading
Berkshire
RG5 4NJ  UK


Compuserve: 101367,2040
E-mail:     WalterWright@compuserve.com
Web Page:   http://ourworld.compuserve.com/homepages/WalterWright



