home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / PSFAX2.ZIP / psfax2 / install.doc < prev    next >
Text File  |  1992-10-17  |  7KB  |  182 lines
  1. The zip file psfax2.zip should have contained the following files:
  2.         psfax2/psfax2.exe
  3.         psfax2/psfax2.cnf
  4.         psfax2/cover.ps
  5.         psfax2/psfax2.c
  6.         psfax2/modem.c
  7.         psfax2/psfax2.h
  8.         psfax2/makefile
  9.         psfax2/install.doc
  10. (EMX Dynamic Link Libraries)
  11.         dll/emx.dll
  12.         dll/emxlibc.dll
  13.         dll/emxio.dll
  14. (Ghostscript files)
  15.         gs252/bdftops.cmd        gs252/fontmap
  16.         gs252/font2c.ps            gs252/gs_2asc.ps
  17.         gs252/gs_dps1.ps        gs252/gs_fonts.ps
  18.         gs252/gs_init.ps        gs252/gs_lev2.ps
  19.         gs252/gs_statd.ps        gs252/gsbj.cmd
  20.         gs252/gsdj.cmd            gs252/gslp.ps
  21.         gs252/gslp.cmd            gs252/impath.ps
  22.         gs252/gsnd.cmd            gs252/ppath.ps
  23.         gs252/landscap.ps        gs252/ps2image.ps
  24.         gs252/pcharstr.ps        gs252/quit.ps
  25.         gs252/prfont.ps            gs252/screen.ps
  26.         gs252/pstoppm.ps        gs252/sym__enc.ps
  27.         gs252/readme            gs252/traceop.ps
  28.         gs252/showpage.ps        gs252/uglyr.gsf
  29.         gs252/timing.ps            gs252/wrfont.ps
  30.         gs252/type1ops.ps        gs252/lines.ps
  31.         gs252/unprot.ps            gs.exe
  32.         gs252/empty.ps
  33.  
  34. You can obtain addtional fonts for use with GNU Ghostscript via anonymous
  35. ftp to wuarchive.wustl.edu in the file:
  36.     mirrors/gnu/ghostscript-fonts-2.5.2.tar.Z
  37.  
  38. Just uncompress and "un" tar this right in the gs252 directory.
  39.  
  40. /*---------------------------------------------------------------------------*/
  41.  
  42. You've chosen to try PSFax/2, a program written by Gary Hennigan, to send
  43. postscript files as faxes. PSFax/2 relies on the GNU utility Ghostscript to
  44. perform a MAJOR portion of it's work, converting the postscript files to
  45. Group 3 fax files. I'm distributing the executable for Ghostscript along
  46. with the support files necessary for running it because I did have some
  47. trouble compiling it. Be aware that this compiled version ONLY has support
  48. for two devices, dfaxhigh and dfaxlow. This means that it will NOT display
  49. postscript on your screen. If you want to take a crack at compiling
  50. GhostScript yourself you can get the source on the same machine and in the
  51. same directory where the extra fonts can be found, as mentioned previously.
  52.  
  53. A few warnings:
  54.  
  55.     I am distributing the source code because I won't have time to
  56. support this release of PSFax/2 in a timely manner. That don't mean you can
  57. do anything you want with it though! The source code can be modified as
  58. much as you like as long as you follow these guidelines:
  59.  
  60.     1) The source code, in whole or in part, can NOT be used in any, or
  61.     sold as a, "for-profit"    program! This means that while I'm giving 
  62.     you the code to do with what you please I don't want ANYONE (other 
  63.     than myself:)) to make a profit from the long hours of labor I put
  64.     into it. At some point I'd like to release sharware version that is 
  65.     multi-threaded, has a WPS interface and has the capability to receive
  66.     as well as send faxes. So....I want to keep the rights to MY source
  67.     code.
  68.  
  69.     2) If you do modify the source code you must remove any reference to 
  70.     myself (except for an acknowledgement:)) that might be contained
  71.     in the source code (probably just the header). This is so I don't
  72.     end up trying to explain something someone else did! It's hard
  73.     enough to figure out what I did!!
  74.  
  75.     3) Also, a VERY small portion of the code is taken from the
  76.     GNU code NetFax so you must adhere to the FSF's restrictions
  77.     as well!
  78.  
  79.     4) While I've found this code works for me I can't guarantee it's
  80.     functionality, as such it should be considered an alpha release
  81.     and NOT relied upon in any way shape or form!
  82.  
  83. That's It! I'd appreciate it greatly if you'd follow these simple guidelines!
  84.  
  85.     Now with that said I would like to receive or at least hear about
  86. any modifications you make, in-particular, anything you had to do to make
  87. PSFax/2 work on other FaxModems. As I said I can't support it in a very
  88. timely manner but I WILL have a small amount of time to devote to any 
  89. problems you may have. I just don't feel justified charging for something 
  90. I can't support in less than a two-week period and that relies so heavily
  91. on free utilities written by others!
  92.  
  93.     For such information just drop me an email note, via the InterNet.
  94.     Send it to:
  95.             ghenniga@NMSU.Edu
  96.  
  97. /*---------------------------------------------------------------------------*/
  98.  
  99. Installing and running PSFax/2 and GNU Ghostscript:
  100.  
  101.     1) The file GS.EXE MUST be someplace in your current path! This is
  102.     important since PSFax/2 does not use a path specification when
  103.     invoking GS.EXE
  104.  
  105.     2) The environment variable, set in your CONFIG.SYS file, GS_LIB 
  106.     must be set to point to the directory where you installed GNU 
  107.     Ghostscript.
  108.         Example:
  109.             SET GS_LIB=C:\OS2BIN\GS252
  110.  
  111.     3) If you have problems with Ghostscript complaining that it can't
  112.     find one of it's support files also try setting the environment
  113.     variable GSDIR to point to the same directory as above.
  114.  
  115.     4) The environment variable FAXPATH must be set to point to the
  116.     directory where the files PSFAX2.CNF and COVER.PS (optional) are
  117.     found.
  118.         Example:
  119.             SET FAXPATH=c:\user\gary\programs\psfax2
  120.  
  121.     5) To obtain help on how to use PSFax/2 itself just type in the name
  122.     of the executable without arguments.
  123.         Example:
  124.             psfax2
  125.  
  126.     6) To configure things like the port, etc., look in the file
  127.     PSFAX2.CNF which is commented.
  128.  
  129.     7) The location of the DLL files, e.g., emx.dll, must be in a
  130.     path included in the LIBPATH statement of your CONFIG.SYS file. If
  131.     you wish to add a separate path for their location you WILL, after
  132.     making the appropriate changes in CONFIG.SYS, have to reboot.
  133.  
  134. Assorted Notes:
  135.  
  136.         PSFax/2 uses the popen function to run Ghostscript, as
  137.     such it can NOT detect any errors that may occur when converting
  138.     a document. This means if you're unsure as to whether or not a
  139.     document can be converted you had better watch while PSFax/2 runs,
  140.     otherwise the remote fax machine will either put out garbage or
  141.     hang up on you promptly.
  142.         Remember, I didn't write the conversion program so chances
  143.     are any problems you may have with it I won't be able to help
  144.     with! If all else fails you can try converting the document on a
  145.     Sun where Ghostscript can be compiled with little or no problem.
  146.  
  147.         I compiled the executable version of PSFax/2 with EMX 0.8e
  148.     and the make file provided with this source.
  149.  
  150.         The file cover.ps is a coverpage I generated using MS Word
  151.     and modified to use variables. It is NOT the greatest thing in the
  152.     world but it is functional. Your best bet is just to add a cover
  153.     page as the first page of the document you intend to send but in
  154.     a pinch you'll probably find cover.ps sufficient.
  155.         You'll want to modify cover.ps to show your address and
  156.     a header you want appear as you desire. The text of the header
  157.     is on line 172 in cover.ps and the address information on lines
  158.     277-279.
  159.  
  160.         For documentation and restrictions on GNU Ghostscript
  161.     please obtain a valid distribution of the source code!
  162.  
  163.         The only configuration I KNOW PSFax/2 works with is as
  164.     follows:
  165.  
  166.             486/33 with 16MB RAM
  167.             Supra FaxModem v.32bis
  168.             Connection with Class 2 fax machines only!
  169.             9600bps connection rate
  170.  
  171. Well, that's it! If you have ANY questions feel free to drop me an email
  172. note. As I said I can't guarantee a TIMELY response but barring a major
  173. catastrophe I WILL get back to you!
  174.  
  175. Gary Hennigan
  176.  
  177. Internet email: (ghenniga@NMSU.Edu)
  178.  
  179. US Mail: Gary Hennigan
  180.      2238 Carreon Pl. #1
  181.      Las Cruces, NM 88005-3869
  182.