  ==============
  - GhostFax/2 -
  ==============

  Version: 1.1, 02-August-1998

  License: FREEWARE

  Platform: IBM OS/2 Warp 3, 4,...

  Author: Jens Schiffler, 86152 Augsburg, Germany

  E-Mail: jens.jakob.schiffler @ student.uni-augsburg.de
          jens-schiffler@freeyellow.com

  WWW: <A HREF="http://www.freeyellow.com/members3/jens-schiffler">
       Jens Schiffler EDV-Service</A>


  Disclaimer
  ==========
  This package is provided as is without any warranty.
  Use at yout own risk.


  License
  =======
  This package is freeware.
  PSExtract.EXE and ReverseFaxBits.EXE copyright (C) 1998 Jens Schiffler.


  Files in this package
  =====================

  KBDVIO32.DLL         DLL needed for PSExtract and RevertFaxBits

  PSExtract.EXE        Extract text from a PostScript file

  ReverseFaxBits.EXE      Reverts the bit order of a tiff fax image file

  FaxFilter.CMD        Filter for use with "printmon"

  sample.txt           Sample file

  readme.txt           this file


  Required: (not contained in this package)
  =========================================

  GhostScript          one of my favourite programs!
                       ftp://ftp.cs.wisc.edu/ghost/aladdin/
                       http://www.leo.org/pub/comp/os/os2/leo

  FaxWorks             if you have OS/2 Warp, you have FaxWorks too
                       http://www.kellergroup.com

  printmon.exe         a small program to redirect output from a printer port
                       http://www.leo.org/pub/comp/os/os2/leo


  Purpose
  =======
  GhostFax/2 allows embedding fax data in any wordprocessor-document. So you
  don't have to use the FaxWorks send-dialog.
  This should be helpful for sending personalized faxes to multiple
  recipients.


  How it works
  ============
  The document must be printed on a PostScript printer object whose output
  (LPT) is redirected to "PSFilter.CMD" via "printmon".

  FaxFilter.CMD will start PSExtract.exe to extract text from the
  PS data. Extracted text will NOT be printed!

  If the extracted text does contain the keyword "FAX", PSFilter will use
  "GhostScript" to create a Tiff Class F file in your "FaxWorks" directory.
  The fax file will be named after the number in "FAX.IDX".
  Otherwise "GhostScript" will print the document on the local
  printer.

  If a fax file has been created, an entry will be added to "FAX.LOG",
  containing the number of the tiff file and the fax information that was
  extracted from the document.
  (to name, to org, to fax, to phone, from name, from fax, from phone)
  The next time FaxWorks checks its logfile (program start), the fax
  will be sent.

  Since GhostScript produces somewhat unusual Tiff Class F files
  (FillOrder=2), RevertFaxBits.EXE is needed to make them readable by
  FaxWorks (FillOrder=1). Although FaxWorks can import GhostScripts tiffg3
  files, it doesn't interpret them correctly in case they were just added
  to the logfile.


  Installation
  ============
  1. Create a PostScript printer object on your desktop. Choose an yet unused
  LPT.

  2. Install the required programs (FaxWorks, GhostScript, Printmon)

  3. Unzip the GhostFax/2 zipfile (e.g. into the directory where
  printmon resides).

  4. Change the *Dir and *Command variable definitions in "PSFaxFilter.CMD"
  to match your configuration.


  Use
  ===
  Start printmon to capture the output from your PostScript printer object:

  printmon LPT2 "c:\printmon\FaxFilter.CMD"

  Use a wordprocessor to create a fax document.
  Insert the following text at the end of the document:

  Text to insert:           Comment:

  <PSEXTRACT>               -- must be uppercase, no leading blanks
  FAX                       -- keyword
  <NEWLINE>                 -- must be uppercase, no leading blanks
  to fax                    -- IMPORTANT: fax number to send to
  <NEWLINE>
  "to name"                 -- OPTIONAL: name of recipient
  <NEWLINE>
  "to org"                  -- OPTIONAL: org of recipient
  <NEWLINE>
  to phone                  -- OPTIONAL: phone of recipient
  <NEWLINE>
  "from name"               -- OPTIONAL: your name
  <NEWLINE>
  "from org"                -- OPTIONAL: your org
  <NEWLINE>
  from fax                  -- OPTIONAL: your fax
  <NEWLINE>
  from phone                -- OPTIONAL: your phone
  </PSEXTRACT>

  Maximum size for extracted text is 8 kilobytes.

  Now format this text with "Helvetica". Chose a small fontsize, to make
  sure the text fits on the last page.

  Since the text will be inserted into Fax.Log, every line containing a colon
  ',' must begin and end with a double quote '"'.

  To send a fax, print the document on the redirected PostScript printer.
  The fax will be added to FaxWorks FAX.LOG file.


  Possible problems
  =================
  Problem: The fax is listed in fax.log but FaxWorks doesn't send it.
  -------------------------------------------------------------------

  Answer: Restart FaxWorks - now it should start sending.


  Problem: The file is printed although it should be faxed.
  ---------------------------------------------------------

  1. Answer:
  Due to the way PSExtract works, its effort will depend on the
  PostScript printer driver settings and the chosen font.
  So you should allow the printer driver to use the builtin fonts as well as
  downloaded fonts and always use a standard PS font like "Helvetica" for
  the <PSEXTRACT>...</PSEXTRACT> section. Otherwise the printer driver may
  convert the text into bitmaps. This may also be the case with very
  small system fonts.

  2. Answer:
  Make sure that all keywords are written in uppercase and stand at the
  beginning of the line. Otherwise PSExtract will fail.


  Problem: Printing a mailmerge document produces one huge fax.
  -------------------------------------------------------------

  Answer: Every fax must be a single print job. Probably your wordpocessor
  isn't capable of splitting mailmerge printout into multiple jobs.


  Problem: it doesnt work at all.
  -------------------------------

  1. Answer: Check installation.

  2. Answer: Have a look at the screen output of the printmon session.

  3. Answer: See if there is a "PSextract.PS" and a "PSExtract.txt" file - if
  not, something may be wrong with the printmon parameters.

  4. Answer: Maybe the FAX.IDX file in the FaxWorks directory contains a
  number already in use.

  5. Answer: Contact the author.


---

Jens Schiffler, 02-August-1998



