 FAXGUI V1.0
         
FAXGUI is a Graphical User Interface for the BGFAX fax program by
B.J. Guillot. BGFAX is without a question the best and most
flexible fax program I have tried, that runs on a HP 100/200LX.
FAXGUI uses only a few of BGFAX features and much more can be
done- that's why I have included my messy source code.
         
This is unsupported freeware and it's also undocumented. The
program is a graphical user interface for a great command line
fax program called BGFAX. I made it some time ago and have used
it a lot. It works great for me, but I never did put together any
documentation due to limited time. So this package is great 
for you that like to play around with your palmtop and are able
to figure out how things work. Actually, it's not that difficult
to set up (I hope), so you should try it! BGFAX is a command line
fax program, but it's superior to any other fax program I have
tried on the HP 200LX- that's why I made this GUI. If you decide 
to use BGFAX, which is a Shareware, you must register in order to
support the author!!! There are not many programmers left which
make programs for DOS and especially not programs that runs on a
HP 100/200LX- so please do REGISTER BGFAX and any other shareware
programs that you use on your palmtop!

In this documentation I will give some basic instructions on how to
install BGFAX, 2FAX and my GUI- FAXGUI. This set of files can be
set up in many different ways since the programs are very flexible
and as we all know- on a HP 200LX you can do anything!

FAXGUI is unsupported freeware and you can do whatever you
like with it. The only thing you can't do is to use the source
code in making a program if you expect the users to pay you
money. It was created using LXBatch 3.0 by Rob Koenis and I have
included a very messy source code if you want to modify anything.
If you do, I would be interested in a copy!

Since the procedure for conversion of a text file to a fax file
takes some memory as does the fax viewer, I recommend you
to use MaxDOS if you want to run the fax program from SysMgr.
MaxDOS is available at SUPER page- http://www.palmtop.net

Ok, what you need is:

FAXGUI.ZIP: from where you got this file which you are reading now.
BGFAX170.ZIP
2BGFAX.ZIP
  
All the above files can be found at SUPER page-
http://www.palmtop.net

As I mentioned earlier, this installation can be done in many
different ways. But here is my way (using MaxDOS):

1. Create a directory on your C drive of your palmtop called     
   C:\BGFAX

2. Create 3 subdirectories called C:\BGFAX\FAXGUI,               
   C:\BGFAX\RECEIVE and C:\BGFAX\SEND.
3. Unzip BGFAX170.ZIP on your desktop and transfer the following     
   files to your C:\BGFAX directory on your palmtop PC:
  
   - BGFAX.EXE
   - BGFAX.FNT
   - MAKEFAX.EXE
   - VIEW.EXE

4. Unzip FAXGUI.ZIP and transfer the following files to your         
   C:\BGFAX\FAXGUI directory on your palmtop PC:
   - FAXGUI.EXE
   - FAXGUI.ICN

5. In FAXGUI.ZIP you can also find following files which you    
   have to transfer to your palmtop:
   - BGFAX.CNF- Place this file in C:\BGFAX.
   - FAXGUI.ENV- Place this file in C:\_DAT.
   - EXTERNAL.BAT- Place this file in C:\BGFAX if you want to use
     some external program such as PalEdit.

6. Then you place MAKEIT.BAT, RECEIVE.BAT, SENDIT.BAT and        
   VIEWIT.BAT in the C:\BGFAX directory on your palmtop.

7. The only file left is 2FAX.BAT. This file you have to place in the same
   directory as you put all the files in the 2BGFAX.ZIP file. In this case,
   I put the file in a A:\BGFAX directory.

INSTALLATION OF FAXGUI IN SYSMGR USING MaxDOS:

In SysMgr press F2- Add. Then fill in following:

Name: FaxGUI
Path: C:\BGFAX\FAXGUI\FAXGUI.EXE|
Comments: ? (upside down- On HP 200LX press {Fn}+{3})
Icon: Press Arrow up/down until you see the FAXGUIs icon.

Then press OK- F10.

Now you have installed FAXGUI but you have to add MaxDOS also.
The reason why you first have to do a normal installation is so
you can catch the FAXGUI icon. Now you press F3- Edit when the 
FAXGUI's icon is highlighted and change the path to:

Path: C:\BIN\MAXDOS.COM C:\BGFAX\FAXGUI\FAXGUI.EXE|
                                                                 
                                                  ^
                                                                 
                             This sign is {Shift}+{\} on HP 200LX

This installation will take about 230Kb of space on your C drive.
As you can see, I am using batch files for all the external
actions and if you have limited space on the C drive, you can
actually do all the work on the A drive and modify the batch
files so you will get a message on screen to remove your flash
card and insert a modem when it's time to send a fax. But how to
exactly do this I leave for you to figure out. But please keep
in mind that you need some space for faxes and also for some temp
files created by BGFAX.


INSTALLATION OF 2BGFAX.ZIP.

You should use this program if you want to send faxes containing 
graphics, such as your signature. Please follow the author's
instructions on how to install and use this program. I have this
program on my A drive and I will here only show you how to
configure FAXGUI so you can use the 2FAX program. 

If everything is done correctly, you should now be able to start
FAXGUI from your SysMgr. When you have done so, press F9- Menu,
and go to Setup. Here you can see Files, Options and Locations. 
Choose Files. Here you can set where your files are located and
you will have one line with 2FAX.EXE. If you leave this line
empty, it means that you don't want to use the external 2FAX 
program. If you do so and press OK- F10, a warning will pop up-
"Can't Find 2FAX.EXE!". Press Enter and you will see a message
"Do you have 2FAX installed?". If you don't have it and do not 
intend to use it, press F6- No.  Everything will be ok. But if
you want to use it, then install the files in 2BGFAX.ZIP on your
flash card and after the 2FAX.EXE line in Menu (F9), Setup, 
Files should look like this (if you have made a directory on the
A drive called BGFAX with all the 2FAX files):

A:\BGFAX

The press OK- F10. If FAXGUI can't find your installation you
will receive a message. If everything ok, you will be back in the
main screen of FAXGUI.


SOME INFORMATION ABOUT FAXGUI AND USAGE

As mentioned earlier, if you want to use an external program such
as PalEdit for writing your faxes, then you have to have
EXTERNAL.BAT in your C:\BGFAX directory. Please edit EXTERNAL.BAT
according to your requirements and then go to Menu (F9), Setup
and Options. After "External Label (F8)" you can now enter for
example "PalEdit" (without quotes) and then press Ok- F10. You
will now see that the F8 label has changed to "PalEdit". If your
EXTERNAL.BAT file is edited correctly, a press of F8 will start
PalEdit.

OBSERVE that if you don't want to use any external programs, then
you will have the line after "External Label (F8)" filled with
"_____" ({Shift}+{-}). Otherwise all the function key labels will
be shifted with funny results.


In this installation document, I will not give you complete
instructions how to use FAXGUI (due to limited time). But I am
sure you will be able to fast figure out how it works since it's
not that complicated. But I will highlight some features here.

In the Menu (F9) you have "Locations" and you will always have
one location in use. This refers to Menu (F9), Setup and
Locations. Here you can enter 3 different locations from where
you are sending a fax- OFFICE, HOME and OTHER. Here you fill in
the data you want the receiver of your fax to see on the top of
the fax paper. You can also fill in any Prefix which is necessary
for dialing- such as a 9 to get the outside line in your office.
So in Menu, Location you choose your current settings for sending
a fax.

         
Then you can see that F2- F7 have following Labels- Make, Send,
Receive, Manual, View and Log. The same options are in the Menu
under "File". 

F2- Make: Here you make your faxes- convert them from TXT format 
    to FAX Format. You can pick several files and also view which
    files that has been picked so far. You can also set the name 
    of the fax files which you want to send- OUTFAX.FAX is       
    default. You will also see 3 buttons in the end of the form- 
    "2FAX" (which is only visible if you have configured 2FAX to
    be used), "Ok" and "Cancel". If you are using a text file    
    formatted to use graphics in the fax you want to send- press 
    "2FAX". If your fax is a plain ASCII file, then it's enough  
    to press "Ok" since it will then be converted using BGFAX's  
    MAKEFAX.EXE. After you have converted a file to FAX format,  
    you will get a prompt where you can choose if you want to    
    view the fax or not before you send it.

F3- Send: If you press F3 you will see the form where you     
    input the data necessary to send a fax. The "Get" button will
    give you the information in the "To" and "Fax#" Fields, if   
    you have a text file called C:\_DAT\CLIPVUE.TXT with         
    information such as "Jorgen Wallgren,65-8421805" (without 
    quotes). This can be done in many ways, but one good way is  
    to do a customized Clip in your Phone Book and use Gilles    
    Kohl's ClipVue. Using the "File" button will enable you to   
    pick the FAX file you want to send (eg. OUTFAX.FAX). But if   
    you going from making the fax (F2) to F3- Send directly,     
    these fields will be entered by the program. Here you can    
    also change or enter a Prefix which may be required in order 
    to get the line. You will also be able to see which          
    "Location" you are currently using and if wrong, you can     
    change it as mentioned earlier. Now you have 2 ways to send  
    your fax using either of the 2 buttons market "Manual" and   
    "Send". If you would like to dial the number manually using  
    the phone, then you use "Manual" and dial the number. When   
    you hear the fax tone on the other end, hit the "Manual"     
    button. On the other hand, you may prefer to let the palmtop 
    dial the number as you have specified then hit the "Send"    
    button- or just hit F10 OK. Please observe that if you have  
    the option "Battery Warning" set to "YES" in your setup, a   
    warning will pop up if you hit F3 and don't have an adapter    
    connected.

F4- Receive: Will set the BGFAX in a receiver mode and the       
    palmtop will wait for someone to send you a fax.

F5- Manual: If you have the palmtop connected to the telephone   
    line and you receive a call and pick up the handset. Oh- you 
    hear a fax signal! Now it's time to hit F5, since you will   
    then set BGFAX in manual receiving mode and you will receive 
    the fax.

F6- View: To view Received or send faxes.

F7- Log: To view your log of messages sent or received. If you   
    have for example not received a fax yet, then you will get a 
    message "Can't Find Any FAXIN.LOG". FAXIN.LOG is created by  
    BGFAX and if you have send or received any faxes you will be
    able to view the log. If you see that some lines in your log 
    are inverted (highlighted in black), this means that there were
    some problems. Normal lines will indicate a successful       
    transmission.


So that's it for now. I hope you will enjoy BGFAX as much as I
have done for the past 1 year+. Yes, I know- I should be punished
for not releasing this earlier!!! But I changed job, moved to a
new appartement and so on- limited time you know and of course
Wrong Priorities!!!  Sorry about that!!!


Jorgen Wallgren
The Palmtop Network
S.U.P.E.R Team- jorgen@palmtop.net

Hint: This is unsupported software, but I have never said no
to a fellow of the HP Palmtop Community- so give it a try if you
are stuck.


P.S. Please remember all the batch files I am using. You can edit
them and do what you want. This is a very flexible set of programs!

