Metropoli BBS
VIEWER: install.doc MODE: TEXT (ASCII)
The zip file psfax2.zip should have contained the following files:
		psfax2/psfax2.exe
		psfax2/psfax2.cnf
		psfax2/cover.ps
		psfax2/psfax2.c
		psfax2/modem.c
		psfax2/psfax2.h
		psfax2/makefile
		psfax2/install.doc
(EMX Dynamic Link Libraries)
		dll/emx.dll
		dll/emxlibc.dll
		dll/emxio.dll
(Ghostscript files)
		gs252/bdftops.cmd		gs252/fontmap
		gs252/font2c.ps			gs252/gs_2asc.ps
		gs252/gs_dps1.ps		gs252/gs_fonts.ps
		gs252/gs_init.ps		gs252/gs_lev2.ps
		gs252/gs_statd.ps		gs252/gsbj.cmd
		gs252/gsdj.cmd			gs252/gslp.ps
		gs252/gslp.cmd			gs252/impath.ps
		gs252/gsnd.cmd			gs252/ppath.ps
		gs252/landscap.ps		gs252/ps2image.ps
		gs252/pcharstr.ps		gs252/quit.ps
		gs252/prfont.ps			gs252/screen.ps
		gs252/pstoppm.ps		gs252/sym__enc.ps
		gs252/readme			gs252/traceop.ps
		gs252/showpage.ps		gs252/uglyr.gsf
		gs252/timing.ps			gs252/wrfont.ps
		gs252/type1ops.ps		gs252/lines.ps
		gs252/unprot.ps			gs.exe
		gs252/empty.ps

You can obtain addtional fonts for use with GNU Ghostscript via anonymous
ftp to wuarchive.wustl.edu in the file:
	mirrors/gnu/ghostscript-fonts-2.5.2.tar.Z

Just uncompress and "un" tar this right in the gs252 directory.

/*---------------------------------------------------------------------------*/

You've chosen to try PSFax/2, a program written by Gary Hennigan, to send
postscript files as faxes. PSFax/2 relies on the GNU utility Ghostscript to
perform a MAJOR portion of it's work, converting the postscript files to
Group 3 fax files. I'm distributing the executable for Ghostscript along
with the support files necessary for running it because I did have some
trouble compiling it. Be aware that this compiled version ONLY has support
for two devices, dfaxhigh and dfaxlow. This means that it will NOT display
postscript on your screen. If you want to take a crack at compiling
GhostScript yourself you can get the source on the same machine and in the
same directory where the extra fonts can be found, as mentioned previously.

A few warnings:

	I am distributing the source code because I won't have time to
support this release of PSFax/2 in a timely manner. That don't mean you can
do anything you want with it though! The source code can be modified as
much as you like as long as you follow these guidelines:

	1) The source code, in whole or in part, can NOT be used in any, or
	sold as a, "for-profit"	program! This means that while I'm giving 
	you the code to do with what you please I don't want ANYONE (other 
	than myself:)) to make a profit from the long hours of labor I put
	into it. At some point I'd like to release sharware version that is 
	multi-threaded, has a WPS interface and has the capability to receive
	as well as send faxes. So....I want to keep the rights to MY source
	code.

	2) If you do modify the source code you must remove any reference to 
	myself (except for an acknowledgement:)) that might be contained
	in the source code (probably just the header). This is so I don't
	end up trying to explain something someone else did! It's hard
	enough to figure out what I did!!

	3) Also, a VERY small portion of the code is taken from the
	GNU code NetFax so you must adhere to the FSF's restrictions
	as well!

	4) While I've found this code works for me I can't guarantee it's
	functionality, as such it should be considered an alpha release
	and NOT relied upon in any way shape or form!

That's It! I'd appreciate it greatly if you'd follow these simple guidelines!

	Now with that said I would like to receive or at least hear about
any modifications you make, in-particular, anything you had to do to make
PSFax/2 work on other FaxModems. As I said I can't support it in a very
timely manner but I WILL have a small amount of time to devote to any 
problems you may have. I just don't feel justified charging for something 
I can't support in less than a two-week period and that relies so heavily
on free utilities written by others!

	For such information just drop me an email note, via the InterNet.
	Send it to:
			ghenniga@NMSU.Edu

/*---------------------------------------------------------------------------*/

Installing and running PSFax/2 and GNU Ghostscript:

	1) The file GS.EXE MUST be someplace in your current path! This is
	important since PSFax/2 does not use a path specification when
	invoking GS.EXE

	2) The environment variable, set in your CONFIG.SYS file, GS_LIB 
	must be set to point to the directory where you installed GNU 
	Ghostscript.
		Example:
			SET GS_LIB=C:\OS2BIN\GS252

	3) If you have problems with Ghostscript complaining that it can't
	find one of it's support files also try setting the environment
	variable GSDIR to point to the same directory as above.

	4) The environment variable FAXPATH must be set to point to the
	directory where the files PSFAX2.CNF and COVER.PS (optional) are
	found.
		Example:
			SET FAXPATH=c:\user\gary\programs\psfax2

	5) To obtain help on how to use PSFax/2 itself just type in the name
	of the executable without arguments.
		Example:
			psfax2

	6) To configure things like the port, etc., look in the file
	PSFAX2.CNF which is commented.

	7) The location of the DLL files, e.g., emx.dll, must be in a
	path included in the LIBPATH statement of your CONFIG.SYS file. If
	you wish to add a separate path for their location you WILL, after
	making the appropriate changes in CONFIG.SYS, have to reboot.

Assorted Notes:

		PSFax/2 uses the popen function to run Ghostscript, as
	such it can NOT detect any errors that may occur when converting
	a document. This means if you're unsure as to whether or not a
	document can be converted you had better watch while PSFax/2 runs,
	otherwise the remote fax machine will either put out garbage or
	hang up on you promptly.
		Remember, I didn't write the conversion program so chances
	are any problems you may have with it I won't be able to help
	with! If all else fails you can try converting the document on a
	Sun where Ghostscript can be compiled with little or no problem.

		I compiled the executable version of PSFax/2 with EMX 0.8e
	and the make file provided with this source.

		The file cover.ps is a coverpage I generated using MS Word
	and modified to use variables. It is NOT the greatest thing in the
	world but it is functional. Your best bet is just to add a cover
	page as the first page of the document you intend to send but in
	a pinch you'll probably find cover.ps sufficient.
		You'll want to modify cover.ps to show your address and
	a header you want appear as you desire. The text of the header
	is on line 172 in cover.ps and the address information on lines
	277-279.

		For documentation and restrictions on GNU Ghostscript
	please obtain a valid distribution of the source code!

		The only configuration I KNOW PSFax/2 works with is as
	follows:

			486/33 with 16MB RAM
			Supra FaxModem v.32bis
			Connection with Class 2 fax machines only!
			9600bps connection rate

Well, that's it! If you have ANY questions feel free to drop me an email
note. As I said I can't guarantee a TIMELY response but barring a major
catastrophe I WILL get back to you!

Gary Hennigan

Internet email: (ghenniga@NMSU.Edu)

US Mail: Gary Hennigan
	 2238 Carreon Pl. #1
	 Las Cruces, NM 88005-3869
[ RETURN TO DIRECTORY ]