                          Text Version of Readme1st.txt

Revision History

02/09/2006 

- Install shield recompiled for license address change.

02/16/2003

- Added printer driver rtf60_mod.prt which enhances compressed print character spacing

10/24/2002

- Removed pfprtc variable from hcfa.upd and fpplus.upd to pass control back to
~\fp\config file.

08/19/2002 
- Revised getname.bat line 11 to correct problem in finding the username in Windows ME. 

from: type reg.txt | find "username" > "us#rname.bat"
to:   type reg.txt | find "Username" > "us#rname.bat"

- Added new drivers "rtf6xx" and mdrtf6xx an alternative drivers when last line of 
report is not properly printed.
---------------------------------------------------------------------------------------

The files in this directory are used to setup filePro to print through Rich Text
printer drivers. This provides the capability to print standard filepro reports with
little or no modification in Rich Text format to "Windows Only" printers.

Prerequisites and limitations -----------------------------------------------------------

fP2RTF is LIMITED for use with character-based filePro in the Windows environment and
is NOT intended as a solution for graphic-based filePro e.g. fileProGI or *NIX systems'
printing.

filePro version 5.0.9 or later is required to use fP2RTF.  

Maximum Report Widths for 8.5" x 11" paper

- Portrait Printing:
  10 pitch  - 80 characters  
  12 pitch  - 96 caharcaters
  condensed - 132 characters

- Landscape Printing:
  10 pitch  - 100 characters
  12 pitch  - 120 characters
  condensed - 168 characters     

Environment ----------------------------------------------------------------------------- 

PFPOSTPRINT: The Rich Text drivers rely on the pfpostprint being properly set. This variable
	should set in startup batch file for filePro.	

PFPRTC: Identfies the Rich Text printer driver to be used. The RTF66 driver will allow
	you to print reliably for most applications and should be set in your startup batch
	file.    	

PFPRT:  Identifies the output filename to use for fP2RTF. This variable is normally set
	by the "~\fp\fp2rtf\getname.bat" file.

Example 

 	set pfpostprint=runbatch.bat
	set PATH=%PFPROG%\fp\fp2rtf;%path%
	call %pfprog%\fp\fp2rtf\getname.bat

The above lines need to be in your startup batch file e.g. FullDev.bat to implement 
fP2RTF. This is automatically done for you if you have used the fP2RTF install shield and 
use a standard startup batch file name e.g. fpplus.bat, hcfa.bat, etc. If you use a batch
file with a name other than one of the standard batch file names, add the above lines near 
the end of your startup batch file and before the your the line that executes the p.exe 
menuname. 

Atlantis Editor: Although other editor programs can potentially be used for viewing and 
printing the output, Atlantis should be used to ensure that the output is properly 
formatted and printed from filePro when using the filePro Rich Text drivers. Atlantis 
provides for proper margin and page control unlike other Rich Text editors/viewers.   

fPfonts: fPtype1a.ttf and fPtype1b.ttf fonts have been specifically designed for fP2RTF. 
Although other fonts can be potentially used, fP Technologies Inc. doesn't guarantee that 
they will be properly rendered or printed with fP2RTF. 
                   
Installation and Setup --------------------------------------------------------------------

Run setup.exe - This will install the fonts, make the fonts immediately available to 
Windows, will install the fP2RTF printer drivers and will create the reserved directories 
required for fP2RTF e.g. ~\fp\fp2RTF, ~\fp\fp2RTF\tmp.

Modify startup batch file - Modify your filePro startup batch file to include the following
lines if it has not been automatically updated by the install shield.

 	set pfpostprint=runbatch.bat
	set PATH=%PFPROG%\fp\fp2rtf;%path%
	call %pfprog%\fp\fp2rtf\getname.bat

Note: The above lines should be added near the end of your filePro startup batch file and 
after any other "set path=" line. "Sample.bat" is provided in the root of the source media
as an example.  

Note: File "~\fp\fp2rtf\Getname.bat" invokes the "RTF66.PRT" driver for development since 
filePro defaults to 66 lines for hardcopies created by "Define Files", "Define Processing", 
etc. You can change the "pfprtc" variable to use the  "RTF60.PRT" driver for runtime
applications if your dominant report format is 60 lines. Either driver can accommodate the
less dominant report format by including the applicable print code in the report or as an
initialization print code.

Troubleshooting ---------------------------------------------------------------------------

Reports run but are not displayed in the Atlantis viewer - This is due to the way some 
systems handle font registration. Although we have made every effort to make our fonts
immediately available without restarting your system, rebooting is sometimes required 
to read the font locations from your system registry. If reports are not displayed after
rebooting your system, contact the applicable technical support team. 

%fpuser%%reportn%.rtf created instead of a report with the actual user name - You are 
running out of environment space so the required variables are not set. Increase your
initial environment space by going to "icon properties" an then memory. Recommend setting 
initial environment to a value of "4096". 

Another method for gaining environment space is to add a line near the beginning of your 
batch file used to start filePro e.g. "FullDev.bat". Add a line to shorten your path when 
running filePro. This will not affect other applications since the original path is 
restored when exiting filePro. 

Example:

set path=c:\windows;c:\windows\command 

Lines do not wrap properly - Reports are displayed but the lines do not wrap properly.
You are probably attempting to use an old version of filePro. Version 5.0.9 or later is 
required. Check your filePro path variables to make sure you are accessing the correct
version of filePro.

Report Lines or Boxes are shown with dashes "-" and "+" - The fonts supplied with fP2RTF
are either missing or not properly registered. Restart your system and then re-install
the fP2RTF update. As a last resort, you can manually install the fonts using your control
panel "fonts" option. This will install the fonts to your windows system directory. The 
fonts are available on the source media under directory ~/fp/fp2rtf as "fPtype1a.ttf" and 
"fPtype1b.ttf", etc. 



