home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / makefax.zip / MAKEFAX.DOC < prev    next >
Text File  |  1994-04-03  |  4KB  |  81 lines

  1. Thank you for using MakeFax 1.1.  Makefax is a simple program
  2. that I wrote to automatically handle the raw .fax files that
  3. BinkleyTerm generates.  
  4.  
  5. First off, Makefax is free and is therefore supplied as is 
  6. with no warranty whatsoever.  All I can say is that it works
  7. for me and will occupy space on your hard disk.  If you like
  8. Makefax please send me a postcard or just a quick netmail so
  9. I can see people are using it which might encourage me to add
  10. new features.
  11.  
  12. Here is how Makefax works.  When Binkley receives a fax it 
  13. seperates every page into a seperate file named pagexxxx.fax.
  14. Makefax combines these files into one Zfax format fax file or
  15. Trio Datafax format file (see bellow for caveats).  The files
  16. are stored in a subdirectory on your hard drive.  For example,
  17. on my system faxes are stored by Binkley in "c:\bt\fax" and the
  18. processed fax files are stored in "c:\bt\fax\receive".  After
  19. the fax is processed the raw .fax files are deleted.  The 
  20. new format file is named MMDDYYYY.### where MM is the current
  21. month, DD the day of the month, YYYY is the year, and ### is
  22. the nth fax for the day.
  23.  
  24. I have included both a 32-bit DOS and 32-bit OS/2 2.x version
  25. of Makefax.  I have also included a sample dofax.cmd and 
  26. dofax.bat file that is called from Binkley.  I use makemsg to
  27. send myself a message whenever a fax arrives.  To keep things
  28. simple Makefax assumes that the configuration file is in the 
  29. current directory.  
  30.  
  31. To install Makefax copy (unzip?) all of the makefax files into
  32. the directory you have chosen.  Modify the .cmd or .bat file 
  33. as appropriate so that the directory containing makefax.cfg
  34. is the current directory when Makefax is run.  Create a 
  35. subdirectory to store the processed fax files.  Have Binkley
  36. call makefax or dofax whenever a new fax is received.An
  37. incoming fax is easily detected by testing for an errorlevel
  38. or checking for .fax files in the Binkley incoming fax directory.
  39.  
  40. You will most likely need to modify the makefax.cfg file.  The
  41. file consists of several lines.  All but the first word on each
  42. line is considered a comment.  If you don't have all of the lines
  43. Makefax expects in your configuration file it will return an
  44. error.  Here are the meanings of the various lines:
  45.   1.  Incoming fax directory (where Binkley store them)
  46.   2.  Processed fax file directory (where they useful ones are)
  47.   3.  Fax file format either ZFAX or DATAFAX at present
  48.   4.  Logfile path (not yet implemented)
  49.   5.  Logfile name (not yet implemented)
  50.  
  51. I intend to add log file generation, and more fax file formats 
  52. if anyone else would care to send me the file format for their
  53. favorite fax program.
  54.  
  55. Caveats of Trio Datafax format:
  56.  
  57. Unfortunately, Binkley throws away some information that the Trio
  58. Datafax software needs.  The Trio fax files store the number of 
  59. lines on each page.  Since this information is not available 
  60. from the pagexxxx.fax files I have set each page to 0x8ff lines.
  61. What this means is that if you scroll too far on the page the
  62. display will suddenly split as it begins to read the next page.
  63. I have printed out several faxes and they all look fine so it
  64. appears to be only a problem with displaying and not printing.
  65. You may also need to rename the files to <whatever>.fax in order
  66. for Trio Datafax to read them.
  67.  
  68. If you find any bugs please contact me at the address bellow.  
  69. Also, if you have formats for other fax programs beside Zfax, or
  70. Trio Datafax send them to me and I might just add them into a
  71. future version of Makefax.
  72.  
  73. Philip Polstra
  74. Sysop the Hangar/2 BBS Fido 1:201/100 FlyNet 196:7050/2 
  75. BBS and FAX (317)583-0732
  76. Internet: polstra@physics.purdue.edu
  77. Snail Mail: PO Box 2, Otterbein, IN 47970-0002  
  78.  
  79. You may FREQ Makefax using magic name "MAKEFAX" from 1:201/100 or
  80. you may ftp it from lowtemp.physics.purdue.edu.
  81.