home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / fax067.zip / fsend.doc < prev    next >
Text File  |  1997-04-21  |  50KB  |  1,101 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                              Fsend Version x.yy
  12.                               Reference Manual
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.            Created 1992 - 1997 by Dr. Harald Pollack & Bernhard Seidl
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30. -------------------------------------------------------------------------------
  31.     ABBREVIATIONS USED IN THIS DOCUMENTATION
  32. -------------------------------------------------------------------------------
  33.  
  34.     DTE . . . . . . . . . . Data Terminal Equipment, your PC
  35.     DCE . . . . . . . . . . Data Communication Equipment, your MODEM
  36.  
  37.     CCITT/ITU T.4 . . . . . International standard for coding fax data.
  38.     CCITT/ITU T.30  . . . . International standard for transmitting fax over
  39.                             a public switched telephone network.
  40.  
  41.     ANSI/EIA/TIA-578-1990 . Asynchronous Facsimile DCE Control Standard
  42.                             Service Class I (the common used class 1).
  43.  
  44.     ANSI/TIA/EIA-592-1993 . Asynchronous Facsimile DCE Control Standard
  45.                             Service Class II (the real class 2.0).
  46.  
  47.  
  48.  
  49. -------------------------------------------------------------------------------
  50.     WARRANTY
  51. -------------------------------------------------------------------------------
  52.  
  53.     There is no warranty on this program. You can use it for your own risk.
  54.     The program should work the best way it can. If you detect some
  55.     malefunction or bugs, please report it with the correspondent FSEND.DEB
  56.     log file to the autor. Without the log file it is almost inpossible to
  57.     find and fix a bug. Common bugs will be corrected if they are of vital
  58.     interrest to the program. Wishes for some extentions (but not printing
  59.     and viewing) and hints for making things better are welcome.
  60.  
  61.  
  62.  
  63.  
  64. -------------------------------------------------------------------------------
  65.     UPGRADING TO A NEW VERSION
  66. -------------------------------------------------------------------------------
  67.  
  68.     New versions of Fsend are always packed in LZH type archives. It is
  69.     recommended to replace all EXE and DLL files and not to use parts of
  70.     older version (especially DLL files). New versions of Fsend often use
  71.     new or modified configuration entries and commandline options. Please
  72.     read all available documentation carefully before using a new version.
  73.  
  74.  
  75.  
  76. -------------------------------------------------------------------------------
  77.     THE CONFIGURATION FILE
  78. -------------------------------------------------------------------------------
  79.  
  80.     The configuration file keeps all information required. FSEND.CFG needs
  81.     to be modified to suit your system. Please have a look at the sample
  82.     configuration file included in the Fsend package. In the following
  83.     section all keywords and parameters are listed and described.
  84.  
  85.  
  86.     NOLOGONBAD
  87.         If Fsend is used in conjunction with third party environment (e.g.
  88.         FaxWorks*, see also FAXLOG and FAXIDX keywords) and this keyword
  89.         is used, no log entry will be generated if there occured an error
  90.         while receiving or no fax session was established. Also see '-#'
  91.         command line parameter.
  92.  
  93.     [TASK <n>]
  94.         Starts a section within the configuration file which only effects
  95.         the selected task. To end a section you can either use another
  96.         [TASK <n>] keyword which would start another section or use the
  97.         keyword [CONNON], described below.
  98.  
  99.     [COMMON]
  100.         All keywords after this statement belong to all tasks.
  101.  
  102.     CONFIGEND
  103.         Fsend will stop working off the configuration file and everything
  104.         following this keyword will be ignored.
  105.  
  106.     KEYFILE <file name>
  107.         The name of a key file which will be used in future versions for
  108.         registration details.
  109.  
  110.     LOGBINKLEYSTYLE
  111.         Using this keyword Fsend will generate BinkleyTerm like log entries.
  112.  
  113.     USROBOTICS
  114.         Special keyword to indicate that a USRobotics modem is used. Must
  115.         be set to allow some workarounds for nonstandardized actions!
  116.  
  117.     OLDDTR
  118.         Fsend uses the methode of 'DTR-drop' (switching modemline DTR off
  119.         and on) to reset the modem and to force a on-hook condition. This
  120.         switching might be done in two ways (different calls to DosDevIOCtl).
  121.  
  122.     NOHEADERLINE
  123.         Default a header line is created on the top of each fax page
  124.         containing date, time and some other informations . To disable
  125.         the creation of that line you have to use 'NOHEADERLINE' keyword.
  126.  
  127.     NOFOOTERLINE
  128.         Default a footer line is created on the bottom of each fax page
  129.         containing the name of recepient (also see '-d' command line parameter)
  130.         and the dialed fax number. To disable the creation of that line you
  131.         have to use 'NOFOOTERLINE' keyword.
  132.  
  133.     NOGARBAGE
  134.         Some older fax modems echo the fax data sent to DCE back to DTE. To
  135.         suppress the logging of all this 'garbage', use this keyword.
  136.  
  137.     NOEOM
  138.         This keyword disables the standardized behavior of Fsend.
  139.         Fax machines, some class 2 and 2.0 fax modem and a minority of class 1
  140.         fax receive software will treat this ITU-T.30 command in a correct
  141.         manner,  but the majority of fax modem and software can not handle this
  142.         command and may malefunction or even hang. Alternativly, the '-noeom'
  143.         command line parameter can be used.
  144.  
  145.     TEXTCOLOR <colorvalue>
  146.         Select color of characters on Fsend status screen:
  147.             0 . . . BLACK
  148.             1 . . . BLUE
  149.             2 . . . GREEN
  150.             3 . . . CYAN
  151.             4 . . . RED
  152.             5 . . . MAGENTA
  153.             6 . . . BROWN
  154.             7 . . . LIGHTGRAY
  155.             8 . . . DARKGRAY
  156.             9 . . . LIGHTBLUE
  157.             10  . . LIGHTGREEN
  158.             11  . . LIGHTCYAN
  159.             12  . . LIGHTRED
  160.             13  . . LIGHTMAGENTA
  161.             14  . . YELLOW
  162.             15  . . WHITE
  163.  
  164.     TEXTBACKGROUNDCOLOR <colorvalue>
  165.         Select color of background on Fsend status screen.
  166.  
  167.     FRAMECOLOR <colorvalue>
  168.         Select color of the frame on Fsend status screen.
  169.  
  170.     TEXTEXTENSION <file extension>
  171.         Fsend uses the extension of a file to determine the method for
  172.         conversation. Default Fsend assumes a file has Tiff format. But
  173.         there are some exceptions. Bitmap files will be treated correctly
  174.         if '.BMP' extension is used. Plane ASCII text files also will be
  175.         treated correctly if '.TXT' extention is used. To determine more
  176.         extentions for text files 'TEXTEXTENSION' can be used.
  177.  
  178.     SENDBUFFER <buffer size>
  179.         Default a buffer of 1024 bytes is used to transmit portions of fax
  180.         data from DTE to DCE. This buffer is used only partially. In worst
  181.         case half of the buffer is filled with data. To optimize transmitting,
  182.         default 8 buffers are used. The buffer size can be determined through
  183.         'SENDBUFFER' keyword. 64 to 4096 bytes are valid buffer sizes.
  184.         Note: The number of buffers is adjusted automatically to have a
  185.         minimum of 4 buffer or 8192 bytes overall size.
  186.  
  187.         Attention: The default values (8 x 1024 bytes) yields in best
  188.         performance and less need of resources. Increasing the size may
  189.         result misbehavior, especially if a rather slow bit rate are used
  190.         at fax negotiation! Buffer size may be decreased if your PC has
  191.         excellent IO-performance (less IO waitstates from mainboard design)
  192.         which yields in less needs for system resources. Do not change the
  193.         buffersize, if using class 1!
  194.  
  195.     RESET <modem command>
  196.         The first action after start up of Fsend is to set the baud rate you
  197.         have determined using 'DATABAUDRATE' keyword. The modem command
  198.         defined with 'RESET' will be sent to DCE after setting the baud rate.
  199.         Attention: At least 'AT' is required for that the modem to detect the
  200.         change of baud rate! But it is recommended to use a modem command
  201.         which resets the modem (e.g. 'ATZ').
  202.  
  203.     DIAL <dial command>
  204.         Default, 'ATD' is used. If an other dial command is required (e.g.
  205.         'ATD0W') 'DIAL' keyword can be used.
  206.  
  207.     INIT <modem command>
  208.         Default no init commands are used by Fsend. Read the sample
  209.         configuration file for fax service class depending additional
  210.         required or useful commands. Do not use any resetting command
  211.         like 'ATZ' or 'AT&F'!
  212.  
  213.     FAXCLASS <1 or 2 or 2.0>
  214.         Select a fax class, your modem is able to handle. Fsend supports
  215.         fax calss 1, class 2 and class 2.0.
  216.         Note: Only class 1 and class 2.0 are standardized! There is no
  217.         general valid standard for class 2.
  218.  
  219.     CLEANUP <modem command>
  220.         Recommanded is at least 'AT', but you can use any modem command.
  221.  
  222.     LOCALPHONE <phone number>
  223.         Your voice phone number. For informational purposes only.
  224.         The phone number will be shown in cover page.
  225.  
  226.     LOCALNAME <your name>
  227.         Will also only be used for informational purposes on cover page.
  228.  
  229.     LOCALID <fax number>
  230.         This value is used to generate the TSI frame. Only use '+', ' ' and
  231.         '0' - '9' characters (as defined in ITU-T.30). All other alphanumerical
  232.         information is not standardized (and therefor discarded).
  233.  
  234.         Attention: This parameter is mandatory, Fsend is stopped if not
  235.         defined!
  236.  
  237.     STATIONID <your company or elsewhat>
  238.         This information is only transmitted, if faxmodem is able to handle
  239.         NSF (NonStandardFacility) frames. Usualy, class 1 modems can do it.
  240.  
  241.     FAXPATH <path>
  242.  
  243.         This entry is MANDATORY!
  244.  
  245.         Defines the path to a directory where fax files are situated and
  246.         ready to send (e.g. 'X:\FAX\'). Also see '-#' command line parameter.
  247.         FAXPATH is also used to form a fully quallyfied path to FAXLOG and
  248.         FAXIDX.
  249.  
  250.         Additional parameters as used for FREC (like SUB and PWD) are ignored.
  251.  
  252.     FAXLOG <file name>
  253.         Filename to FAX.LOG and only neccessary, if other than
  254.         'FAX.LOG'. Received faxes from FREC will be joined to FAX.LOG.
  255.         Each well received fax (hangup code 0) is flagged as 'Rcvd'. If fax is
  256.         received in (partial) error or even no session was established at all,
  257.         entry in FAXLOG is flagged as 'BadRcv'. See also keyword NOLOGONBAD.
  258.         Also see '-#' and '-FaxLog' command line parameter.
  259.  
  260.     FAXIDX <file name>
  261.         Filename to FAX.IDX and only neccessary, if other than
  262.         'FAX.IDX'. Also see '-#' command line parameter.
  263.  
  264.     FAXDEBUG <[+]file name>
  265.         This is the name of the log and debug log file of Fsend. Nearly all
  266.         activities are stored in this file. If a '+' precedes the path,
  267.         append mode is used: one log is chained to the next. Select NUL as
  268.         filename to disable logging.
  269.         The logfile contains a lot of informations in case of errors or
  270.         situations where help is needed. Bugreports to the author are only
  271.         sensful if this logfile is part of the report.
  272.  
  273.     FAXBAUDRATE <DTE-DCE bit rate>
  274.         Most modem require a fixed speed of 19200 bps for phase C data
  275.         transmission in class 2. Also class 1 defines a standard DCE-DTE
  276.         bitrate of 19200 bps. Only class 2.0 is capable of handling bitrates
  277.         higher than 19200 bps.
  278.  
  279.     DATABAUDRATE <DTE-DCE bitrate>
  280.         Bitrate for initialisation of modem. Some older modem, especially those
  281.         which are not capable of high speed data communication, do require a
  282.         baudrate of 2400 bps.
  283.  
  284.     DIALWAIT <seconds>
  285.         Time to wait between two dial tries.
  286.  
  287.     DIALRETRY <count>
  288.         Number of dial tries. Default is '0'. That means after an unsuccessful
  289.         call, fsend will terminate. If 'DIALRETRY' is defined, Fsend will try
  290.         to establish a connection for the determined number of times until
  291.         terminating.
  292.  
  293.     COVERPAGE <YES or NO>
  294.         If set to YES a cover page containing several informations (e.g. your
  295.         name, voice and fax phone number, name and fax number of the receiver,
  296.         a short comment and so on) will be created as first fax page. Also see
  297.         '-d' and '-m' command line parameters.
  298.  
  299.     COVERGRAPHIC <Bitmap file name>
  300.         The named bitmap is placed in front of the cover page. Only black and
  301.         white bitmaps (bitcount is 1 and planes is 1) can be used. Bitmaps
  302.         smaller than a faxpage (1728 pixels) are centered, larger bitmpas are
  303.         right truncated. If a covergraphic is defined, Fsend automatically
  304.         uses fine resolution for the coverpage. The resolution of following
  305.         pages depends on the filetyp and the usage of NOEOM (or '-NoEOM'):
  306.  
  307.         Pages produced from plain text are of normal resolution (204 x 98 dpi),
  308.         bitmaps from a BMP are of fine resolution (204 x 196 dpi) and fax pages
  309.         based on TIF are from a resolution as neer as the original (normally
  310.         fine resolution). If 'NOEOM' is enabled, all pages follow the
  311.         resolution of the coverpage.
  312.  
  313.     COMPORT <serial port>
  314.         This keyword is mandatory. Even if Fsend is called using a port handle
  315.         (from Frec) this keyword must exist! The name of the device is used to
  316.         create a unique identifier for internal use!
  317.  
  318.     INITFIFO
  319.         If a hardware fifo (UART 16550) is detected by COM-device driver, the
  320.         fifo is initiallized to Rx=8 and Tx=16.
  321.  
  322.     CAPABILITIES <vr,br,wd,ln,df,ec,bf,st[,jp]>
  323.         Default is 1,3,0,2,0,0,0,0,0 which means: high resolution, maximal
  324.         9600 bps in V.29 modulation, 8 inches paperwidth, endless paperlength,
  325.         1-D Huffman coded data, no ECM, no BFT and 0 ms wait between scanlines.
  326.  
  327.         With these values, successful transmission to each receiving station is
  328.         possible. If the receiver is not capable of any of these values, Fsend
  329.         will adjust to such values, the receiver can (and must) handle.
  330.  
  331.         vr (vertical resolution):
  332.             00 . . . normal 204x98  dpi (R8 x  3.85/mm),
  333.             01 . . . fine   204x196 dpi (R8 x   7.7/mm),
  334.             02 . . . high   204x392 dpi (R8 x  15.4/mm),
  335.             04 . . . extra  408x392 dpi (R16 x 15.4/mm),
  336.             08 . . . 200x100 dpi,
  337.             10 . . . 200x200 dpi,
  338.             20 . . . 200x400 dpi,
  339.             40 . . . 300x300 dpi,
  340.             80 . . . 400x400 dpi (not defined in T.32)
  341.         All values for 'vr' are in hexadecimal notation!
  342.         Not all resolutions are supported!
  343.  
  344.         br (bit rate):
  345.             0 . . .  2400 bps
  346.             1 . . .  4800 bps
  347.             2 . . .  7200 bps
  348.             3 . . .  9600 bps
  349.             4 . . . 12000 bps
  350.             5 . . . 14400 bps
  351.  
  352.         wd (page width):
  353.                     R8    R16   200   300   400
  354.                     d/mm  d/mm  dpi   dpi   dpi
  355.             0 . . . 1728  3456  1728  2592  3456 (A4 width)
  356.             1 . . . 2048  4096  2048             (B4 width)
  357.             2 . . . 2432  4864  2432             (A3 width)
  358.             3 . . . 1216  2432                   (A5 width)
  359.             4 . . .  864  1728                   (A6 width)
  360.             Not all resolutions are supported!
  361.  
  362.         ln (page length):
  363.             0 . . . A4 length, 297 mm (not supported)
  364.             1 . . . B4 length, 364 mm (not supported)
  365.             2 . . . Unlimited length
  366.  
  367.         df (compression scheme):
  368.             0 . . . 1-D Modified Huffman (ITU T.4),
  369.             1 . . . 2-D Modified read (ITU T.4),
  370.             2 . . . 2-D Uncompressed mode (ITU T.4), (not supported)
  371.             3 . . . 2-D Modified modified read (ITU T.6)
  372.  
  373.         ec (error correction):
  374.             0 . . . do not use ECM
  375.             1 . . . Enable Annex A/T.30, ECM (only supported in class 1)
  376.             2 . . . Enable Annex C/T.30, half duplex (not supported)
  377.             3 . . . Enable Annex C/T.30, full duplex (not supported)
  378.  
  379.         bf (binary file):
  380.             00  . . Disable file transfer modes,
  381.             01  . . Select enable BFT (ITU T.434), (not supported)
  382.             02  . . Select document transfer mode, (not supported)
  383.             04  . . Select edifact mode, (not supported)
  384.             08  . . Select basic transfer mode, (not supported)
  385.             10  . . Select character mode Annex D/T.4, (not supported)
  386.             20  . . Selcet mixed mode Annex E/T.4, (not supported)
  387.             40  . . Select processable mode (ITU T.505) (not supported)
  388.         All values for 'bf' are in hexadecimal notation !!!
  389.  
  390.         st (time/scanline):
  391.                     vr = 0    vr > 0
  392.             0 . . .  0 ms      0 ms
  393.             1 . . .  5 ms      5 ms
  394.             2 . . . 10 ms      5 ms
  395.             3 . . . 10 ms     10 ms
  396.             4 . . . 20 ms     10 ms
  397.             5 . . . 20 ms     20 ms
  398.             6 . . . 40 ms     20 ms
  399.             7 . . . 40 ms     40 ms
  400.  
  401.         jp (JPEG coding):
  402.             00  . . Disable JPEG coding,
  403.             01  . . Enable JPEG coding (ITU T.81), (not supported)
  404.             02  . . Full color mode, (not supported)
  405.             04  . . Enable preferred Huffman tables, (not supported)
  406.             08  . . 12 bits/pel/component, (not supported)
  407.             10  . . No subsampling (1:1:1), (not supported)
  408.             20  . . Custom illuminant, (not supported)
  409.             40  . . Custom gamut range (not supported)
  410.         All values for 'jp' are in hexadecimal notation !!!
  411.  
  412.     NOECMDUMMY
  413.         This keyword suppresses the generation of a (first) dummy HDLC frame.
  414.         This dummy frame is sent to receiver if (a least) the first HDLC frame
  415.         is twice rejected. The reason why that is so still is unknown, but it
  416.         seems, that some fax modem does not send a frame limiting character
  417.         (HDLC-flag) in front of first frame.
  418.         Obviously, not all fax machine accept such a dummy frame, so you must
  419.         disable it with this keyword.
  420.  
  421.     NEXTPAGE <text>
  422.         If the footer line feature is not disabled, Fsend will create an
  423.         information at the bottom of each line saying if there is an other
  424.         page following the current one or if it was the last. The default
  425.         text says "NEXT PAGE FOLLOWS" but it might be exchanged by any other
  426.         text using 'NEXTPAGE'.
  427.  
  428.     LASTPAGE <text>
  429.         Same as 'NEXTPAGE' but this text will be created if the current page
  430.         was the last one. The default text says "END OF FAX PROCEDURE".
  431.  
  432.     DEBUGIDLEPRIORITY <value> or DEBUGREGULARPRIORITY <value>
  433.         These keywords, which are mutual exclusive, define the priority (0-31)
  434.         for the task (thread) which writes the data to FAXDEBUG file. Default
  435.         is IDLEPRIORITY 30. Change this setting only, if you are absolutly sure
  436.         knowing what you do! Lower priority may yield in a endless blocking
  437.         debug_thread! No data will be written to FAXDEBUG and FSEND may become
  438.         'uncloseable'. On very slow or high stressed machines, you can
  439.         try REGULARPRIORITY 0, if IDLEPRIORITY blocks writing to FAXDEBUG.
  440.  
  441.     LOADIDLEPRIORITY <value> or LOADREGULARPRIORITY <value>
  442.         These keywords, which are mutual exclusive, define the priority (0-31)
  443.         for the task (thread) which reads in text or bitmaps and converts it
  444.         to a fax pixel image while fax date is transmitted. Default is
  445.         IDLEPRIORITY 31. Lower priority may slow down reading, yielding in
  446.         no correct faxtransmission! LOADPRIORITY must be higher than
  447.         DEBUGPRIORITY. On slow or high stressed machines, try
  448.         REGULARPRIORITY 1. You can disable this priority switching by using
  449.         the '-fastload' commandline switch (which is in fact the same as
  450.         REGULARPRIORITY 0).
  451.  
  452.     LINESPACE <n>
  453.         Same as ~LINE= in a text file but global. The generation of HEADER and
  454.         FOOTER is not affected of this parameter. Default is '0' which means
  455.         leading is 20% of font height.
  456.  
  457.     LOADFONT <x:\path\faxfont.FFF>
  458.         You can load a prebuild (with FONTEDIT.EXE, supplied with the package)
  459.         fax font for using in conversion of text files. Each 'handbuild' font
  460.         has a font name (defined by you when saving the fontdata in FONTEDIT)
  461.         which is a key to this font. This is a well tested, but quick and dirty
  462.         feature of FSEND. Use it right or forget it. An other possibility, to
  463.         construct fonts, is FAXVIEW, see also FAXVIEW.DOC!
  464.  
  465.     TEXTFONT <fontname>
  466.         Default the font '16x16_standard', which is hardcoded in FSEND, is
  467.         used to generate pixelimage from text files. With this keyword, you
  468.         can define an alternate, but formerly preloaded with LOADFONT, fax
  469.         font. This font is used if no '~FONT=<fontname>' directive is placed
  470.         in a text file and in the informational part of COVERPAGE.
  471.  
  472.         Note: fontname is the NAME of the font (as you define when saving
  473.         font data in FONTEDIT) and is NOT the name of the fontfile used in
  474.         LOADFONT!
  475.  
  476.         Inline directives, which MUST start at the beginning of a new line,
  477.         for text files:
  478.  
  479.             ~FONT=<fontname>
  480.                 Select a preloaded (LOADFONT) fax font. Use here the NAME
  481.                 of the font you have given when saving fontdata in FONTEDIT
  482.                 and not the name of the fontfile! At the start of each new
  483.                 text file, 'fontname' is resetted to TEXTFONT.
  484.  
  485.             ~IMAGE=<filename.BMP>
  486.                 Defines a black and white bitmap to be inserted at that
  487.                 position into the pixel image of the text file. Bitmaps
  488.                 smaller than the fax page, will be centered. Larger bitmaps
  489.                 will be right truncated. Fax pages from text files will be
  490.                 generated in normal resolution (204 x 98 dpi). Therefor,
  491.                 the bitmap (which is normaly in a symetrically resolution)
  492.                 is vertically reduced in resolution (not shrinked). Two
  493.                 consecutiv pixel lines are 'ored' together to form the new
  494.                 pixelline. In further versions of Fsend, resolution of text
  495.                 pages may be defineable.
  496.  
  497.             ~LEFT=<mm>
  498.                 Default 8 mm border on left side of page is used. You can
  499.                 define any other suitable value. Once altered, left margin
  500.                 is constant for the whole fax text document and is affected
  501.                 only by a new ~LEFT statement.
  502.  
  503.             ~RIGHT=<mm>
  504.                 Default 8 mm border on right side of page is used. You can
  505.                 define any other suitable value. Once altered, right margin
  506.                 is constant for the whole fax text document and is affected
  507.                 only by a new ~RIGHT statement.
  508.  
  509.             ~LINE=<mm>
  510.                 The default value of '0' yields in a interline spacing of
  511.                 aproximately 20 % of fonthight. You can chose any value
  512.                 between 0 and 270. The special value -1 disables interline
  513.                 spacing and is so preferable when blockgraphic should be
  514.                 converted. See also LINESPACE above.
  515.  
  516.     INFOFONT <font name>
  517.         Default the font '8x8_standard', which is hardcoded in FSEND, is used
  518.         to generate pixelimage for HEADER, FOOTER, NEXTPAGE and LASTPAGE.
  519.         With this keyword, you can define an alternate, but formerly preloaded
  520.         with LOADFONT, faxfont.
  521.  
  522.         Attention: The hardcoded font has some special characters in it, if
  523.         building a new font, DO NOT alter this characters from 8x8_standard.
  524.  
  525.         Note: font name is the name of the font (as you define when saving
  526.         fontdata in FONTEDIT) and is not the name of the fontfile used in
  527.         LOADFONT!
  528.  
  529.     LOGLEVEL <n>
  530.         Writing to log file (also see 'FAXDEBUG' keyword) depends on this
  531.         value (0 to 5):
  532.             0 . . do NOT write to FAXDEBUG (is equal to 'FAXDEBUG NUL')
  533.             1 . . ERROR only
  534.             2 . . ERROR + SEND + RECEIVE only
  535.             3 . . ERROR + SEND + RECEIVE + ACTION only
  536.             4 . . ERROR + SEND + RECEIVE + ACTION + WAIT FOR only
  537.             5 . . ERROR + SEND + RECEIVE + ACTION + WAIT FOR + INFO (default)
  538.  
  539.     DEBUG
  540.         Enables a lot of stuff for debugging. Do not use, because LOG will
  541.         increase enormous.
  542.  
  543.     FRECCFG <configfile> [commandline switches for FREC]
  544.         The full name and path to Frec configuration file. If defined, Fsend
  545.         may be used as a frontend to act as pollserver and faxreceiver. In
  546.         fact the same as Frec in conjunction with Fsend.
  547.  
  548.         If (optional) commandline switches are defined, the call to FREC is
  549.         performed like:
  550.  
  551.         FREC -c<configfile> -k<outcompression> -p<comhandle> [-task<n>]
  552.             -sWAIT_OK <commandline switches for FREC>
  553.  
  554.         If TaskNo is defined, it is also submitted.
  555.  
  556.         It is no longer supported, to choose between FREC.EXE and FREC.DLL!
  557.         From now on, FSEND searches for FREC.DLL in LIBPATH and if not found,
  558.         FREC.EXE is called.
  559.  
  560.     NOATD
  561.         Switch to suppress 'ATD' in class 1 if an EOM situation occures and
  562.         modem is not able to handle ATD in class 1 correct. Try also 'NOEOM'
  563.         keyword to workaround modem misbehaviour.
  564.  
  565.     MINPAGELENGTH
  566.         Can be used, to determine the minimal length of fax page. Default is
  567.         3 cm, because a lot of fax machines and fax modem will reject shorter
  568.         pages (by RTN). Note: The maximum valid value is 30 cm.
  569.  
  570.     INBOUND <path to inbound>
  571.         If DESTNAME and DESTADDR are also defined, a netmail (????????.PKT)
  572.         is created each time a fax is transmitted.
  573.  
  574.     DESTNAME <string>
  575.         If this, INBOUND and DESTADDR is defined in FSEND.CFG, a netmail
  576.         is created and addressed to.
  577.  
  578.     DESTADDR <FidoNet style address>
  579.         Must be defined to create announcing netmail.
  580.  
  581.     SRCNAME <string>
  582.         Used to form the 'From:' part of the announcing netmail.
  583.         Default is: "FSEND".
  584.  
  585.     SRCADDR <FidoNet style address>
  586.         Normally this is the address of local system. Defaults to DESTADDR.
  587.  
  588.     SUBJECTSENDFAX <string or %>
  589.         Used in creation of announcing netmail on transmitting fax. If '%' is
  590.         the first (or only) character, the filename from which the fax is sent
  591.         will be placed in subject part of netmail.
  592.         Default is: "Announcement of outgoing FAX".
  593.  
  594.     FLAGDIR <path>
  595.         Path, were a semaphor file is created if used in conjunction with
  596.         the -FaxLog feature and a redial is neccessary.
  597.  
  598.     EXITSEM <semaphor name>
  599.         Semaphor file to force mailer (BinkleyTerm or Cantaloup) to exit with
  600.         error level. Should be either BTEXIT (for Binkley) or CLEXIT (for
  601.         Cantaloup).
  602.         In combination with TASK and ExitErrorLevel a semaphor file is created.
  603.  
  604.     EXITERRORLEVEL <level>
  605.         Errorlevel for mailer when forced to exit by semaphor.
  606.  
  607.  
  608.     Additional information:
  609.  
  610.     All file and path specifiers in configuration file are checked against
  611.     %<environment>%. If a valid environment entry is found, %<env>% is
  612.     replaced by the content of the variable, e.g.:
  613.  
  614.         SET LOG=D:\LOGFILES
  615.  
  616.         BinkLog %LOG%\BINKLEY%TASK%.LOG
  617.         FaxDebug %LOG%\FREC%TASK%.LOG
  618.  
  619.     A special 'replacement' is done in all file name entries in configuration
  620.     file when '%TASK%' is detected. %TASK% (must be uppercase) is replaced
  621.     by the defined task number.
  622.  
  623.     If a debug file is defined and this debug file can not be accessed, than
  624.     a 'default' in the root of the current drive (\FSEND.DEB) is used instead.
  625.  
  626.     It is strongly recommended to use a debug file! In case of misbehaviour
  627.     99% of faults can be localized quickly and (from the author :-).
  628.  
  629.  
  630.  
  631. -------------------------------------------------------------------------------
  632.     COMMAND LINE PARAMETERS AND SYNTAX
  633. -------------------------------------------------------------------------------
  634.  
  635.     The format of the commandline is as follows:
  636.  
  637.     FSEND <switch> <switch> ...
  638.  
  639.     Each argument must immediatly follow the switch (no blanks). Some switches
  640.     allow entries which have blanks, eg. to form names or comments.
  641.  
  642.     -ForceV33
  643.         If receiver signals bit rates higher than 9600 bps always use V.33
  644.         (class 1 only).
  645.  
  646.     -ForceV17
  647.         If receiver signals bitrates higher than 4800 (and even if V.17 is
  648.         not signaled) use V.17 (class 1 only).
  649.  
  650.     -SendPWD<numerical_password>
  651.         Is used to create a PWD (PassWorD) frame for an outgoing fax. This
  652.         must be used if destination has password protection for incoming fax.
  653.         Attention: Only '0' - '9', '#' and '*' are valid characters! All other
  654.         characters are invalid and strictly discarded by Fsend. String length
  655.         is limited to 20 characters. '-SendPWD' can be used in Class 1 and 2.0
  656.         (if supported by the modem) only!
  657.  
  658.     -SendSUB<numerical_subaddress>
  659.         Is used to create a SUB (SUBaddress) frame for an outgoing fax. This
  660.         can be used, to send to a special address in receiver's domain (if
  661.         supported by receiver).
  662.         Attention: Only '0' - '9', '#' and '*' are valid characters. All other
  663.         characters are invalid and strictly discarded by Fsend. String length
  664.         is limited to 20 characters. '-SendSUB' can be used in Class 1 and 2.0
  665.         (if supported by the modem) only!
  666.  
  667.         See also '-g' commandline switch to define phonenumber.
  668.  
  669.     -FaxLog
  670.         This parameter enables a special mode of operation. For proper
  671.         operation of this feature 'FAXLOG', 'FAXIDX' and 'FAXPATH' have
  672.         to be defined correctly. Fsend will send a fax that is created
  673.         by other applications fax printer driver.
  674.  
  675.         If Fsend is called with '-task<n> -c<file name> -FaxLog' parameters
  676.         it will extract all required information from FAXLOG and
  677.         start sending the fax if the given date and time entry is empty or
  678.         either equal or less actual date and time.
  679.         Note: Also see new errorlevel values!
  680.  
  681.         To create a fax throug other applications fax printer driver you
  682.         have to act as follows:
  683.  
  684.         An application (or simply 'COPY CON LPTx', where x is the printer
  685.         port assigned to special printer driver) must print to
  686.         fax printer driver. If the data send to the printer driver is not
  687.         plain ASCII text you have to create a 'FAX.CGS' file which contains
  688.         all information required to create the fax. If the data send to the
  689.         printer driver is plain ASCII, this data also can be placed at the
  690.         very beginning of the text file. Following lines are required:
  691.  
  692.             >>TO=<name of receiver>,*,<fax no of receiver>
  693.             >>AT=<time to send>,<date to send>
  694.  
  695.         The first line will make the fax printer driver creating the fax. A
  696.         FAXLOG entry like '<idx no>,,,1,Spool ,,1,0,99,,<name of
  697.         receiver>,,<fax no of receiver>,,,,,,,,,' will be created.
  698.         The second line is optional. If used the fax will not be sent until
  699.         date and time arrived. Using both lines the printer driver will
  700.         create a log entry like '<idx no>,23-Jan-97,14:32,1,Spool ,,1,0,99,,
  701.         <name of receiver>,,<fax no of receiver>,,,,,,,,,'.
  702.  
  703.         The date must be strictly entered in the format DD-MON-JJ, where
  704.         MON is the english abbreviation for the month with first character
  705.         uppercase. Day of month must contain leading zero if below 10!
  706.  
  707.         Optionally, a third line containing a short 'comment' (for cover
  708.         sheet) can be added:
  709.  
  710.             >>INFO=<comment>,*,*,*
  711.  
  712.         Maybe, in further versions, a simple textmode utility will be
  713.         supplied, to create (and maintain) FAXLOG file for the
  714.         above use ...
  715.  
  716.     -Quiet
  717.         Fsend is switched to an absolutly quiet mode of operation. Only
  718.         log file is written and very short messages to stderr at the begin
  719.         and end of operation. You can redirect output of stderr to a file
  720.         by using '2>>error.log' which yields in:
  721.  
  722.             + 14 Mar 11:50:41 FSEND Begin, v1.23b
  723.               14 Mar 11:50:46 FSEND HangUp <hangup_code>
  724.             - 14 Mar 11:50:46 FSEND End. [<errorlevel>]
  725.  
  726.     -Task<n>
  727.         Where <n> specifies the task number to be used. See also [TASK <n>]
  728.         and [COMMON] keywords in configuration file. If this parameter is
  729.         not used the common task will be used.
  730.  
  731.     -c<config file>
  732.         Default Fsend assumes the configuration file is named FSEND.CFG and
  733.         located in the current directory. The '-c' command line parameter
  734.         can be used to define an other path and file name.
  735.  
  736.         Configuration file can also be supplied via environment:
  737.  
  738.         SET FAX=x:\path\fsend.cfg
  739.  
  740.         or
  741.  
  742.         SET FAXCFG=x:\path\fsend.cfg
  743.  
  744.     -o<file name> [<page indicator>]
  745.         Input file for fax transmission. You can send black and white
  746.         bitmaps from type .BMP or .TIF or text files (see 'TEXTEXTENSION'
  747.         keyword). More that one '-o' parameter is allowed in a single
  748.         command line. Wildcards (*, ?) also are allowed. A blank separated
  749.         'page indicator', following the file name is possible. For more
  750.         information on that see '-o@' command line parameter.
  751.         Note: The 'page indicator' must be one number (only digits,
  752.         no blanks) and should have not more than 20 digits.
  753.  
  754.     -o@<file name>
  755.         As an enhancement to the '-o' option, you can define a pointer
  756.         file, which contains all the file names instead. Each line must
  757.         contain only one file name. Wildcards are allowed. In accordance
  758.         to 'selective poll' a 'page indicator' may also be used:
  759.  
  760.         Content of such a pointer file:
  761.  
  762.             X:\PATH\NEWLIST.TXT
  763.             Y:\OTHERPATH\FILELIST.TXT 1
  764.             Z:\NEWPATH\ECHOLIST.TXT 2
  765.  
  766.         Which means, NEWLIST will be sent to everybode whereas FILELIST only
  767.         will be sent if remote station is supplying '1' in SEP frame and
  768.         ECHOLIST only will be sent if '2' is supplied in SEP frame. If the
  769.         remote station does not use any SEP frame, than ALL three files will
  770.         be sent.
  771.  
  772.     -g<phone number>
  773.         Enter the number of the fax you want to send to. The number is
  774.         transmitted as it is to the modems dial command. So special dial
  775.         modifiers may be included here.
  776.  
  777.         Alternativly to the '-PollSUB' a 'subaddres' in receivers domain may
  778.         also here specified by appending a "'" and the (numerical) subaddress:
  779.  
  780.         "-g0043 1 701 99" or "-g47110815" or "-g0456789'123" are valid
  781.         dial commands. Last one shows subaddressing to 123. Read also
  782.         the definition of FAXPATH in FREC.DOC.
  783.  
  784.     -#<idx no>
  785.         This is a special commandline option to easyly send fax files
  786.         created by other applications. Simpley enter the index number of the
  787.         fax file to be sent (e.g. for FX000123.FAX you have the enter
  788.         '-#123'). If you want to send the fax file which is created last,
  789.         enter '-#?' and the idx number will be generated using information
  790.         in FAX.IDX file. If 'NOLOGONBAD' is not defined, an entry in
  791.         FAX.LOG is done.
  792.  
  793.     -d<name> or
  794.     -TO:<name>
  795.         You can define here the name of the receiver of the fax file, e.g.
  796.         '-dMr. John Smith'. Do not use any special characters the operating
  797.         system interprets for own use, or use the '"' character to embed, like
  798.         '"-dMr. & Mrs. Hoover"'.
  799.  
  800.     -r<name> or
  801.     -FROM:<name>
  802.  
  803.         You can define here a 'LocalName' which will overwrite the name
  804.         supplied in CFG. See '-d' for some restrictions.
  805.  
  806.     -m<comment>
  807.         Like in '-d' option, you can enter a SHORT message to the receiver,
  808.         which is print in the coverpage. Sample: '-mLast news from our
  809.         meeting'.  This option implies, that '-o' can be omitted. Short
  810.         fax messages without generation of a text file are possible, only
  811.         a coverpage (must be defined in configuration file) is sent.
  812.  
  813.     -NoCover
  814.         A simple 'shortcut' to suppress generation of coverpage if defined
  815.         in configuration file.
  816.  
  817.     -NoEOM
  818.         Commandline switch to suppress EOMs in multidocument fax. See NOEOM
  819.         keyword in configuration file.
  820.  
  821.     -x
  822.         Each fax page is stored in a bitmap (FXDTnnnn.BMP) in the same form
  823.         as it is transmitted. The 'nnnn' is a number from 0001 to the page
  824.         count. This parameter is useful for verifying the generation of
  825.         cover page and text files.
  826.  
  827.     -h or -?
  828.        A short help screen is shown. This printout can not be redirected into
  829.        a file, because VIO functions are used!
  830.  
  831.     -v<faxviewer>
  832.         An external fax viewer (please refer FAXVIEW.DOC for more information)
  833.         can be used to display an outgoing fax in realtime on the screen.
  834.  
  835.         There are TWO possible modes to use:
  836.  
  837.         1) <faxviewer> is the name of a compatible viewer (obviously
  838.             FAXVIEW.EXE), which will be started (by DosStartSession) and closed
  839.             by FSEND (by WM_QUIT).
  840.  
  841.         2) <faxviewer> is the name of a pipe (eg. '\PIPE\LINE1'). In this case
  842.             the viewer (FAXVIEW.EXE) must be already loaded (see FAXVIEW.DOC)
  843.             and is only actived by FSEND (by pipe).
  844.  
  845.     -BITS or -LARGE or -STANDARD or -PREVIEW
  846.         Scaling option for optional external fax viewer.
  847.         Note: Do not use 'scaled' option in FAXVIEW.EXE.
  848.  
  849.     -p<com port handle>
  850.         If this parameter is used, FSEND assumes it is called by any other
  851.         application or other front end.
  852.         Note: The port handle is not the same as the port number (e.g. COM1)!
  853.         All initialisation must be done by calling front end.
  854.  
  855. -------------------------------------------------------------------------------
  856.     Assumptions of WORKING CONDITIONS:
  857. -------------------------------------------------------------------------------
  858.  
  859.     There are some dedicated working conditions for FSEND, depending on what
  860.     job it shall do. FSEND recognizes these condition by interpreting its
  861.     commandline switches:
  862.  
  863.     -P<porthandle>  -FDIS/-FDTC  -G<phoneno>  -FaxLog  CONDITION  Use
  864.     ---------------------------------------------------------------------
  865.         NO              NO          NO          NO          (1)     FE
  866.         NO              NO          NO          YES         (2)     S
  867.         NO              NO          YES         NO          (3)     S
  868.         NO              NO          YES         YES         (4)     !
  869.         NO              YES         NO          NO          (5)     !
  870.         NO              YES         NO          YES         (5)     !
  871.         NO              YES         YES         NO          (5)     !
  872.         NO              YES         YES         YES         (4)     !
  873.         YES             NO          NO          NO          (6)     PS
  874.         YES             NO          NO          YES         (7)     S
  875.         YES             NO          YES         NO          (8)     S
  876.         YES             NO          YES         YES         (4)     !
  877.         YES             YES or -B   NO          NO          (9)     PS,S,NoInit
  878.         YES             YES         NO          YES        (10)     !
  879.         YES             YES         YES         NO         (10)     !
  880.         YES             YES         YES         YES         (4)     !
  881.  
  882.     FE ..... Frontend
  883.     PS ..... PollServer
  884.     S ...... FaxSender
  885.     NoInit . CFGs 'Init' not used
  886.     ! ...... irregular condition
  887.  
  888.  
  889.     1)  Standalone frontend. FSEND can act as a sender/pollserver or receiver
  890.     (by calling FREC). At least one file (-o) must be specified or coverpage
  891.     must be enabled AND a message (-m) must be supplied. If no filename or no
  892.     coverpage is enabled, FSEND stops with error, else FSEND waits for a caller
  893.  
  894.     2)  Standalone fax sender. All information for this job is excerpted from
  895.     FAXLOG. if no fax with status 'Spool' or no phonenumber in FAXLOG, FSEND
  896.     stops with error, else FSEND starts to send.
  897.  
  898.     3)  Standalone fax sender. At least one file (-o) must be specified or
  899.     coverpage must be enabled AND a message (-m) must be supplied. If no
  900.     filename or no coverpage is enabled, FSEND stops with error, else FSEND
  901.     starts to send by calling the supplied phonenumber.
  902.  
  903.     4)  Irregular combination. Phonenumber is TWICE defined (by -g and in
  904.     FAXLOG). FSEND stops with error.
  905.  
  906.     5)  Irregular combination. -FDIS or -FDTC is defined, but no porthandle
  907.     is supplied by -p. FSEND stops with error.
  908.  
  909.     6)  Fax pollserver called with a porthandle from any other application
  910.     which has allready opened the com port (and initialized). At least one
  911.     file (-o) must be defined or coverpage must be enabled AND a message (-m)
  912.     must be supplied. If no filename or no coverpage is enabled, FSEND stops
  913.     with error, else FSEND waits for a caller.
  914.  
  915.     7)  Fax sender called with porthandle from any other application which has
  916.     allready opened the com port (and initialized). All information for this
  917.     job is excerpted from FAXLOG. If no fax with status 'Spool' or no
  918.     phonenumber in FAXLOG, FSEND stops with error, else FSEND starts to send.
  919.  
  920.     8)  Fax sender called with porthandle from any other application which has
  921.     allready opened the com port (and initialized). At least one file (-o)
  922.     must be specified or coverpage must be enabled AND a message (-m) must be
  923.     supplied. If no filename or no coverpage is enabled, FSEND stops with
  924.     error, else FSEND starts to send by calling the supplied phonenumber.
  925.  
  926.     9)  Fax pollserver called with a porthandle from any other application
  927.     which has allready opened the com port (and initialized) and has allready
  928.     an active fax connection in or prior to PHASE B. At least one file (-o)
  929.     must be specified or coverpage must be enabled AND a message (-m) must be
  930.     supplied. If no filename or no coverpage is enabled, FSEND stops with
  931.     error, else FSEND immediatly enters PHASE B of a transmitting station,
  932.     assuming the supplied values for DIS or DTC. If not used in Class 1, -b
  933.     commandline switch may be supplied instead of DIS/DTC. Due to the fact,
  934.     that there is no difference for FSEND if satisfying a poll or simply does
  935.     a send job, this condition can also be used by any other application to
  936.     make a normal send (other application must allready have dialed/answered
  937.     and have a fax connect).
  938.  
  939.     This is the normal situation, when FREC detects a caller who want to poll
  940.     a fax and routes the call to FSEND to satisfy poll.
  941.  
  942.     10) Irregular combination. DIS or DTC supplied (in fact an active
  943.     connection) and phonenumber (from commandline or FAXLOG) is also
  944.     supplied.
  945.  
  946. -------------------------------------------------------------------------------
  947.     ERROR LEVELS USED BY FSEND:
  948. -------------------------------------------------------------------------------
  949.  
  950.     0 . . . all sendjobs (in accordance to standard) done.
  951.     1 . . . wrong commandline switch
  952.     2 . . . phonenumber AND called with FDTC/FDIS OR no files to send
  953.     3 . . . no or wrong configuration file
  954.     4 . . . Nothing to do in FAX.LOG (no 'Spool' entries)
  955.     5 . . . Too less information in or no FAX.LOG
  956.     6 . . . Spool active, but delayed
  957.     10  . . Invalid comport or used from other application
  958.     11  . . No Connect after dial (can be BUSY, NO CARRIER, NO ANSWER etc.)
  959.     12  . . Error (user ESC) after dial
  960.     20  . . DATA connect in frontend mode, session still active
  961.     100 . . DebugThreadError
  962.     101 . . BitmapThreadError
  963.     102 . . CompressionThreadError
  964.     103 . . ComInThreadError
  965.     104 . . TimeThreadError
  966.     200 . . send maybe correct, but nonstandard termination
  967.     251 . . Error after connection
  968.     253 . . ModemError
  969.     254 . . ComPortError
  970.     255 . . Serious problem, can be anything, use '2>error.log' to localize
  971.  
  972.  
  973.  
  974.  
  975. -------------------------------------------------------------------------------
  976.     HISTORY
  977. -------------------------------------------------------------------------------
  978.  
  979.     Version 1.34:
  980.         Large parts of code (esp threadhandling, memoryallocation, exception-
  981.     handling and CFG/CMD-handling) was redesigned. All parts of code, which are
  982.     also in FREC and ANSW were put to FAXPROC, which is from now on a dynamic
  983.     link library (FAXPROC.DLL). Linking of C-runtime is never more statically,
  984.     instead, C-runtime is linked dynamically (at loadtime) for FSEND, FAXPROC
  985.     and IMGPROC. So, the overall amount of codesize was reduced. Some keywords
  986.     in CFG were also altered:
  987.  
  988.         INBOUNDSEND    -->    INBOUND (sorry for twice altering)
  989.         SUBJECTSEND    -->    SUBJECTSENDFAX
  990.     NEW:
  991.         InitFifo (see above)
  992.  
  993.     Not longer supported:
  994.         FRECDLL (see FRECCFG)
  995.  
  996.     Finally, the COM port open methode is now checked in FAXPROC. Only if COM
  997.     is opend in READWRITE and SHARE_DENYREADWRITE, work is continued! I hope
  998.     some problems (when called from a mailer, which uses a patched MAXCOMM to
  999.     open COM in SHARE_DENYNONE mode) are solved now. Also SIO.SYS in
  1000.     'share mode' should never more work!
  1001.  
  1002.     Maybe some users will disagree, but 'sharing' a communication port is NOT
  1003.     usefull on a multitasking environment! Each application MUST have unique
  1004.     access to its own resources.
  1005.  
  1006.     Version 1.33:
  1007.         Only internal test version and not distributed.
  1008.  
  1009.     Version 1.32:
  1010.     Serious bug in XON/XOFF handling caused an infinit loop (and 100% CPU used).
  1011.         In combining TIF procedures in IMGPROC.DLL, check for validy of
  1012.         PhotometricInterpretation was lost. Is fixed also now.
  1013.  
  1014.     Version 1.31:
  1015.         FSENDs commandline switches are partly changed to have same
  1016.         meaning as in FREC:
  1017.             old         new
  1018.             '-i'     =>     '-o'
  1019.             '-f'     =>     '-l' (undocumented)
  1020.             '-w'     =>     '-p'
  1021.             '-FROM' =>     '-r'
  1022.             '-r'    =>  sending of raw data file is not more supported!
  1023.  
  1024.         Like FREC, FSEND can from now on also 'show' a picture of the outgoing
  1025.         faxpage by using FAXVIEW.
  1026.  
  1027.         Due to enhancements in FREC, FAXPATH must be (once) defined and is
  1028.         used to form fully qualified drive, path and filename for FAXIDX and
  1029.         FAXLOG. Both FAXLOG and FAXIDX have defaults (FAX.LOG and FAX.IDX)
  1030.         and should only be (re)defined if other than default. As FREC can
  1031.         accept more than one FAXPATH, FSEND will use (if same CFG for both
  1032.         is supplied) only the FIRST found entry!
  1033.  
  1034.  
  1035.     Version 1.30:
  1036.         some new keywords (read above) and parts of T.32 are implemented.
  1037.         Also higher resolutions like in T.30 defined will be supported
  1038.         (untested)!
  1039.  
  1040.     Version 1.29:
  1041.         from now on, FSEND and FREC can use one and the same configuration
  1042.         file. Certain keywords were updated, like:
  1043.             INBOUND -> INBOUNDSEND and INBOUNDREC
  1044.             SUBJECT -> SUBJECTSEND and SUBJECTREC
  1045.         It is recommanded, to distinguish between Frec and Fsend portions
  1046.         of configuration file by '[TASK <n>]' keyword.
  1047.  
  1048.     Version 1.28:
  1049.         a serious and hard to find BUG in FSEND was eliminated. This BUG was
  1050.         only active if SOURCE was 2-D Read (G4) TIF AND faxtransmission was
  1051.         2-D Read AND first transmitted page was THIS 2-D Read TIF.
  1052.  
  1053.         Many THANKS to Massimo Fantin from Italy, who has 'needled' me to
  1054.         find this bug (some code for IMGPROC was still also in FSEND and was
  1055.         only called if source AND transmission was in 2-D)
  1056.  
  1057.         TIFPROC.DLL now is named IMGPROC.DLL, because in WARP 4.0 MMOS2 is a
  1058.         new DLL named TIFPROC.DLL!
  1059.  
  1060.     Version 1.27
  1061.         is build with MINOR changes from version 1.25a. TIFPROC.DLL is
  1062.         reduced because LZW (Lempel, Ziv & Welch) compression is under
  1063.         patent regulation in some countries. So TIFPROC is no longer able
  1064.         to handle Compression=5 (normally known as LZW). TIFPROC is 'under
  1065.         study' and will be changed/upgraded when LZ-compression will work
  1066.         in unrestricted manner!
  1067.  
  1068.     Versions 1.25 and 1.26
  1069.         were ALL REJECTED! To much problems arised with TIFPROC.DLL!
  1070.  
  1071.     Version 1.26
  1072.         is released, because 1.25 was WRONG (do NOT use it) ....
  1073.  
  1074.  
  1075.  
  1076.  
  1077. -------------------------------------------------------------------------------
  1078.     FINALY:
  1079. -------------------------------------------------------------------------------
  1080.  
  1081.     Please also read carefully the sample configuration file.
  1082.  
  1083.     FSEND and FREC are updated either if there is a serious bug or if some
  1084.     new or requested features were added. The documentation is updated, if
  1085.     there is time in the authors 36 hour day :-).
  1086.  
  1087.     Please fell free to contact the autor:
  1088.         FidoNet 2:310/14.59
  1089.         Internet Harald.Pollack@OMV.CO.AT
  1090.  
  1091.     Many thanks to Bernhard Seidl and Gerold Pummer for excessive tests
  1092.     of various (beta) versions of Fsend.
  1093.  
  1094.     And last, but not least, my greatest thanks to WOLFGANG HOFFMANN,
  1095.     who was in fact the one who believes in this program and who gave me
  1096.     all the necessary standards to do things in the right way.
  1097.  
  1098.  
  1099. <end of doc>
  1100.  
  1101.