home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / bgfax147.zip / WHATS.NEW < prev   
Text File  |  1995-05-02  |  37KB  |  749 lines
  1. Changes between BGFAX 1.47 and BGFAX 1.40                     MON 2 MAY 95
  2. =========================================                     ============
  3.  
  4. New help files (*.TXT in HELPME.ARJ) included for...
  5.  
  6.        PC Board     Wildcat!     Maximus/2     MainDoor/2     WWIV
  7.  
  8. NOTE: Tranquility Base (BGFAX support BBS) is now on the Internet!
  9.       You can TELNET/FTP/VMODEM to IP address 198.65.189.2 to logon.
  10.       We now have an ISDN connection (64K) rather than the old slow
  11.       V.34 (29K) connection, so things are much faster now.  This is
  12.       a _different_ IP address than before.
  13.  
  14. The BGFAX147.ARJ file is protected using a ARJ Security Envelope.
  15.  
  16. AUSTRALIA: Users of BGFAX in OZ who do not have access to a credit card
  17.       can now register by cheque or money order.  See the REGISTER.AUS
  18.       file included with this archive for more information.
  19.  
  20. <<< BRIEF SUMMARY OF MAJOR CHANGES >>>
  21.  
  22.    a. Faxworks/2 fax format added
  23.    b. Many BGFAX/2 releated bugs have been fixed (TRAP errors, etc.)
  24.    c. BGFAX/DOS now allows one to use hardware (CTS) flow control while
  25.       sending, which helps under multitasking environments (DV and Windows)
  26.    d. Many LaserJet and DeskJet printing (PCL) problems fixed
  27.  
  28. New stuff
  29. ~~~~~~~~~
  30. 1. Finally have added another fax format type into BGFAX.  Now, along with
  31.    ZFAX and QLIIFAX format, BGFAX supports the Faxworks/2.  Faxworks/2 is
  32.    the fax program that comes on the OS/2 Warp Bonus Pack.
  33.  
  34.    At present, VIEW.EXE will _NOT_ correctly view Faxworks/2 files.  You
  35.    must use the Faxworks/2 program ("open log" function) to do this.  Since
  36.    you must use the "open log" function, you must tell BGFAX to save faxes
  37.    in the \FAXWORKS directory rather than the \BGFAX directory.
  38.  
  39.    NOTE: When BGFAX saves the files, the naming convention is as follows:
  40.  
  41.          ZFAX 2.xx.... FAXnnnn.FAX
  42.          QuickLink.... FAXnnnn.QFX
  43.          Faxworks/2... FXnnnnnn.FAX
  44.  
  45. 2. BGFAX/2 now allows for OS/2 programs to pass the hot com handle number
  46.    to BGFAX/2.  (Binkley/2, MainDoor/2, Lora/2 people.)  Example startup
  47.    of BGFAX/2 if using Lora/2 where the com handle is passed as the third
  48.    command line parameter:
  49.  
  50.          bgfax2 /fax c:\bgfax h%3 z
  51.  
  52.    If you are using a strange OS/2 BBS program like VBBS which does not
  53.    pass OS/2 com handles to BGFAX/2, you will need to use a V in front
  54.    of the com port NUMBER (not the handle) on the BGFAX/2 command line
  55.    to tell BGFAX/2 to use "VBBS compatibility mode".  Example for COM1...
  56.  
  57.          bgfax2 /fax c:\bgfax v1 z
  58.  
  59. 3. New command line switch: BGFAX /HOST /SB     Spawn DOBBS.CMD, OS/2
  60.    version only, relating to use with Maximus/2, see MAXIMUS2.TXT
  61.  
  62. 4. BGFAX/2 will now store the COM HANDLE in the DOBBS.CMD file instead of
  63.    the com port number as it was doing before.  (BGFAX/DOS will continue
  64.    to write the com port number in the DOBBS.BAT file.)
  65.  
  66. 5. New command line switch: BGFAX /SEND /HW     Hardware (CTS) flow control
  67.  
  68.    This will tell BGFAX to use CTS handshaking when sending the fax image.
  69.    If you are using a Class 2.0 modem, BGFAX will automatically set the
  70.    correct flow control command (AT+FLO=2 for RTS/CTS).  If you are using
  71.    a Class 1 or 2 modem, you _might_ (you might not) have to change the
  72.    BGFAX dial string so that the modem is set to be in the same mode as
  73.    BGFAX.  Example, for Rockwell-based modems, you might have
  74.      ds=ATM2&K4DT      for a regular XON/XOFF send fax dial string
  75.      ds=ATM2&K3DT      for a hardware RTS/CTS send fax dial string
  76.  
  77. 6. BGFAX /HOST mode can now be terminated by semaphore files.  When BGFAX
  78.    is running in /HOST mode, if you put a file called "EXITnnn.SEM" in the
  79.    BGFAX directory, it will cause BGFAX to exit with errorlevel nnn.
  80.    i.e., "EXIT72.SEM" will cause /HOST mode to terminate with level 72.
  81.    This is useful on multitasking or networked systems.
  82.  
  83. 7. BGFAX will now pass a second parameter to the DOPRINT.BAT (DOPRINT.CMD)
  84.    file.  The second parameter will be the remote fax ID, with underscores
  85.    replacing spaces.  This can be used in case your EXEPRINT.BAT/CMD file
  86.    will need to scan for certain bad numbers (fax advertising) and not
  87.    print them, or, can be used to pass to programs designed to page you
  88.    with the remote fax ID.  Confused??  Don't worry about it.  Here is a
  89.    sample of the new DOPRINT.BAT/CMD file:
  90.  
  91. CALL C:\BGFAX\EXEPRINT.BAT C:\BGFAX\FAX0872.FAX                (old way)
  92. CALL C:\BGFAX\EXEPRINT.BAT C:\BGFAX\FAX0873.FAX 713_893_9124   (new way)
  93.  
  94. 8. Some of the older Class 1 modems do require a 19200 shift.  I thought
  95.    all Class 1 modems behaved like the Hayes Optima 288, but apparently
  96.    I was wrong about that.  (The Optima 288 doesn't use 19200 shifting,
  97.    while I recently discovered modems such as the Hayes Accura 14400 do
  98.    require 19200 shifting.)  To handle this situation, a new com port
  99.    modifier is available, the minus sign.  Example:
  100.  
  101.          bgfax /fhay:713_555_1212 c:\bgfax 2- z
  102.  
  103.    The above line would tell BGFAX to use Class 1 mode on COM2, but it
  104.    will perform 'old-style' Class 1 DTE shifting.  (Notice it is "2-"
  105.    instead of "2").  If you are using a Hayes Accura 14400 in BGFAX's
  106.    /HOST mode, make your BGFAX.CNF file say po=2- if you are using COM2.
  107.  
  108. 9. A new command line switch for VIEW, /LP --- this switch means you plan
  109.    to use 'legal sized' paper on your laser printer.  (Legal sized paper
  110.    is 8.5 x 14" instead of the normal USA 8.5 x 11" size).
  111.  
  112. 10. New command line switch: BGFAX /HOST /ND     No incoming data callers
  113.  
  114. Bugs fixed
  115. ~~~~~~~~~~
  116. 1. In /SEND mode, if the input fax file is not found, BGFAX will immediately
  117.    exit.  If BGFAX send mode is in extended results mode (/ER command line
  118.    switch), this file not found condition will cause BGFAX to exit with
  119.    errorlevel 18, rather than errorlevel 0 (generic failure).
  120.  
  121. 2. Numeric result codes work better when BGFAX is used in rear-end mode
  122.    (Required for people using Syncronet software.)
  123.  
  124. 3. Fixed problem when running BGFAX in /HOST mode when using a FOSSIL
  125.    driver.  BGFAX 1.36 and 1.40 would refuse to answer the phone.
  126.  
  127. 4. I think I fixed the problem with BGFAX/2 generating a TRAP-D error
  128.    on many systems when trying to run it in /HOST mode.
  129.  
  130. 5. Fixed problem with BGFAX thinking a "CONNECT 14400 REL" was a 0 bps
  131.    connection.  :-) ... Before, BGFAX was expecting "CONNECT 14400/REL".
  132.  
  133. 6. If you were receiving a 2D-MR coded fax and BGFAX was not receiving
  134.    a valid 2D-MR RTC code at the end of the page, BGFAX was trying to
  135.    'help' by adding a 1D-MH RTC code.  (It should have added a 2D-MR
  136.    RTC code, as this version should now do.)
  137.  
  138. 7. I have attempted to fix a problem during PCX conversion that existed
  139.    in VIEW 1.40 and 1.40A.
  140.  
  141. 8. Many people have reported problems trying to print faxes on Laser or
  142.    Desk Jet printers.  This VIEW.EXE update tries to fix the problem by
  143.    sending printer output via software interrupt $17, rather than opening
  144.    'LPT1' as a 'binary file'.  The printing screen has had an overhaul as
  145.    well.  Here is some example command line parameters:
  146.  
  147.        view /p40              will print to LPT1 via Int 17 (new way)
  148.        view /p40:lpt1         will print to LPT1 via Int 17 (new way)
  149.        view /p40:lpt2         will print to LPT2 via Int 17 (new way)
  150.        view /p40:hello.you    will print to file 'HELLO.YOU' via binary file
  151.        view /p40:+lpt1        will print to LPT1 via binary file (old way)
  152.  
  153.    Under OS/2, it appears as if printing the old way is faster, that's why
  154.    I made it possible to print using the old way (by inserting the plus).
  155.  
  156. 9. A user with a new Practical Peripheral's V.FC modem reported trouble
  157.    sending faxes.  Apparently, the modem would echo "ATDTphonenumber   "
  158.                                       ...instead of "ATDT phonenumber"
  159.    which would confuse BGFAX and BGFAX/2.  The extra spaces in the modem
  160.    output are the problem.  This update to BGFAX should fix this problem.
  161.  
  162. ##############################################################################
  163.  
  164. Changes between BGFAX 1.40 and BGFAX 1.36                    SUN  1 JAN 95
  165. =========================================                    =============
  166.  
  167. <<< BRIEF SUMMARY OF MAJOR NEW FEATURES >>>
  168.  
  169.    a. OS/2 executables now included
  170.    b. EXAR based fax modem related bugs in BGFAX addressed
  171.    c. VIEW now supports VESA SVGA display modes for viewing faxes
  172.    d. VIEW now supports printing in PCL mode (LaserJet, DeskJet)
  173.    e. CALLER ID info in /HOST mode is now saved to DOBBS.BAT files
  174.  
  175. <<< Detailed summary of changes and new features >>>
  176.  
  177. OS/2 EXECUTABLES NOW INCLUDED!
  178. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  179.    BGFAX2.EXE and MAKEFAX2.EXE are included with this release!
  180.  
  181.    You can use BGFAX2.EXE for sending faxes under OS/2.
  182.  
  183.    For receiving faxes with BGFAX2.EXE under OS/2, you must be using a BBS
  184.    software or Fido mailer software that is OS/2 native (i.e., Lora/2 or
  185.    MAINDOOR/2).  If your BBS or Fido mailer software is DOS native (i.e.,
  186.    FrontDoor or InterMail) you still must use BGFAX/DOS.
  187.  
  188.    If you are using BGFAX/2 in /HOST or /SEND mode, a small change in the
  189.    BGFAX.CNF file will be required.  Instead of using "po=1" to represent
  190.    COM1, for example, you will need to use "p2=1".  Where "po=" is the port
  191.    used in BGFAX/DOS and "p2=" is the port used in BGFAX/2.
  192.  
  193.    Why this change?  Say, under DOS you have "po=2e8x5", but under OS/2, you
  194.    have SIO set up to map $2e8, IRQ5 to COM4, therefore "p2=4".
  195.  
  196.    BGFAX/DOS creates *.BAT files (DOBBS.BAT, DOPRINT.BAT).  BGFAX/2 will
  197.    instead create *.CMD files (DOBBS.CMD, DOPRINT.CMD).
  198.  
  199.    Please report any TRAP errors to me.  I tried my best to make sure I
  200.    squashed all TRAP related bugs, but just a few days ago, someone said they
  201.    got a TRAP error in /HOST mode.
  202.  
  203. Bugs fixed
  204. ~~~~~~~~~~
  205. 1. Many USR and PPI owners often came home from work to find BGFAX sitting
  206.    there on the screen after several hours.  This big, bad bug is now fixed.
  207.    BGFAX will now timeout correctly after 40 seconds of no activity.
  208.  
  209. 2. BGFAX was not correctly logging some hangup status codes on Class 2.0
  210.    modems.  (Such as the +FHS:A2 code, which the string-to-integer unit
  211.    was reporting as "0", now it should report "A2", etc.)
  212.  
  213. 3. Numerous VIEW.EXE problems have been touched.  EGA graphics mode now
  214.    appears to work on EGA-only systems.
  215.  
  216. New stuff
  217. ~~~~~~~~~
  218. 1. VIEW now supports VESA SVGA resolution modes of 800x600 and 1024x768.
  219.  
  220.    If VIEW detects a functioning VESA adapter, it will use a default
  221.    resolution of 800x600.  If you want to use 1024x768, you will have to
  222.    force VIEW into that mode by using the /1024 command line switch.
  223.    Your VESA card must support use 64K banks for 1024x768 mode to work.
  224.  
  225.    If something goes wrong, VGA mode can always be forced with /VGA switch.
  226.  
  227.    I have tested both of the new high res modes on my Farenheight 1280
  228.    and Trident SVGA cards.  (1024x768 mode was very slow, even on my
  229.    486DX4/100 machine, that's why I default VESA mode to 800x600).
  230.  
  231.    Please note that many SVGA cards are _not_ VESA compatible.  Sometimes,
  232.    these non-standard cards come with VESA-drivers for DOS.
  233.  
  234. 2. VIEW.EXE now supports printing using the PCL command set (i.e., you can
  235.    now print faxes on LaserJet and DeskJet printers!)  To tell BGFAX to use
  236.    PCL mode, start VIEW with the /P40 command line parameter.
  237.  
  238. 3. Before VIEW would always use "LPT1" when printing.  Now, you can tell
  239.    VIEW which port (or file) to use, i.e.:
  240.  
  241.       VIEW /P24            <-- means use 24-pin printer on LPT1
  242.       VIEW /P26:LPT2       <-- means use Bubble Jet on LPT2
  243.       VIEW /P40:LPT3       <-- means use Laser Jet on LPT3
  244.       VIEW /P24:DUMP.PRN   <-- means 24-pin printer output saved to file
  245.         [ Send DUMP.PRN to printer doing "COPY DUMP.PRN PRN" at DOS prompt ]
  246.  
  247.  
  248. 4. Caller ID information is now logged in the DOBBS.BAT files in /HOST mode.
  249.    (BGFAX presently supports Rockwell Caller ID, ZyXEL Caller ID will
  250.    probably be added in the future.)
  251.  
  252.    To demonstrate, here's the data from the modem (DEBUG.LOG):
  253.  
  254. 12-03-94 17:21:58  f=[RING]
  255. 12-03-94 17:21:59  f=[DATE = 1203]
  256. 12-03-94 17:21:59  f=[TIME = 1727]
  257. 12-03-94 17:21:59  f=[NMBR = 7138939124]
  258. 12-03-94 17:21:59  f=[NAME = GUILLOT B J    ]
  259. 12-03-94 17:22:04  f=[RING]
  260. 12-03-94 17:22:05  f=[ata]
  261. 12-03-94 17:22:17  f=[CARRIER 28800]
  262. 12-03-94 17:22:17  f=[PROTOCOL: LAP-M]
  263. 12-03-94 17:22:17  f=[COMPRESSION: V.42BIS]
  264. 12-03-94 17:22:17  f=[CONNECT 28800/ARQ]
  265.  
  266.    Here's the data from the BGFAX.LOG:
  267.  
  268. 12-03-94 17:22:04  caller id [1203 1727 7138939124 GUILLOT_B_J]
  269. 12-03-94 17:22:04  answering phone
  270. 12-03-94 17:22:17  extra id [PROTOCOL: LAP-M]
  271. 12-03-94 17:22:17  extra id [COMPRESSION: V.42BIS]
  272. 12-03-94 17:22:17  data inbound [CONNECT 28800/ARQ]
  273. 12-03-94 17:22:18  reliable connection
  274.  
  275.    And, here's what DOBBS.BAT ends up looking like:
  276.  
  277. C:\BGFAX\EXEBBS.BAT 28800 3E8X3 819 /ARQ 1203 1727 7138939124 GUILLOT_B_J
  278.  
  279.    If no caller ID was detected, DOBBS.BAT would look like this:
  280.  
  281. C:\BGFAX\EXEBBS.BAT 28800 3E8X3 819 /ARQ N/A
  282.  
  283. 5. One user reported problems with MSDOS 5.0 not letting BGFAX/DOS use
  284.    commas in the fax number when /SENDing.  i.e.,
  285.  
  286.       bgfax /send output.fax 555.1212    actually uses "555,1212"
  287.  
  288. EXAR based fax modems supported correctly
  289. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  290.    People with EXAR based fax modems (a few non-USA users) can now correct
  291.    the dreaded DLE/error, bad scan line problem by putting a /EX at the end
  292.    of the BGFAX command line.  This seems to reduce nearly all bad scan
  293.    lines.  DO NOT USE /EX ON A NON-EXAR MODEM.  If you try using the /EX
  294.    switch on a Rockwell, USR, or Sierra based fax modem, your faxes will
  295.    become garbled.
  296.  
  297.  
  298. Important change for multinode users of BGFAX
  299. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  300. BGFAX before offered a syntax of "BGFAX /FAX path c x p" where 'c' is the
  301. com port, 'x' is Q or Z, and 'p' was a PID number.  The 'p' syntax was
  302. also available with the /PID:ppp switch.  Now, the old syntax for using
  303. a PID number on the command line is removed.  So, if you are running BGFAX
  304. in a multi-node environment, you now must use "BGFAX /FAX c x /PID:p"
  305. I think it is more readable this way.
  306.  
  307.     BGFAX /FAX C:\BGFAX 1 Z /PID:5
  308.  
  309. ...would mean BGFAX5.LOG would be created instead of BGFAX.LOG.
  310.  
  311. ##############################################################################
  312.  
  313. Changes between BGFAX 1.36 and BGFAX 1.30                    SUN 25 SEP 94
  314. =========================================                    =============
  315.  
  316. IMPORTANT: Copy BGFAX.EXE, MAKEFAX.EXE, VIEW.EXE, FNTEDIT.EXE, and the
  317.            BGFAX.FNT file into your BGFAX directory if you are upgrading
  318.            from a previous version of BGFAX.
  319.  
  320. An OS/2 version of BGFAX is in beta testing, but it is not released at
  321. this time due to the number of unresolved TRAP-D errors reported.
  322.  
  323. This version does not fix the EXAR/DLE problem many European users have
  324. reported.  I just received an EXAR modem two days ago, but it was too
  325. close to the release date to work on the problem.  I hope to address this
  326. problem in the very near future.
  327.  
  328. New Features
  329. ~~~~~~~~~~~~
  330. 1. VIEW.EXE has been greatly modified.  Typing "VIEW" by itself, in a
  331.    directory that contains fax files will bring up a list of all the faxes
  332.    in the directory, with the remote fax ID's if a FAXIN.LOG is also
  333.    located in that directory.
  334.  
  335.    VIEW can now also print faxes on 24-pin dot matrix printers as well as
  336.    Canon Bubble Jets.  (Lasers, Deskjets, and 9-pin dot matrix printers
  337.    are not currently supported.)
  338.  
  339. 2. A new BGFAX.FNT file is included.  Two fonts, rather than just a single
  340.    font are now supported in MAKEFAX.EXE.
  341.  
  342.    /F0  16x16      /F0 /HR  16x32     [ 100 characters per line ]
  343.      ( This /F0 font is actually a 8x16 font, the original BGFAX font )
  344.    /F1  16x16      /F1 /HR  16x32     [ 100 characters per line ]
  345.  
  346.    Font 0 (/F0) is the font BGFAX uses for generating the top of page
  347.    headers on outgoing faxes.
  348.  
  349.    Font 1 (/F1) is the font BGFAX will use when converting ASCII text
  350.    files to FAX files.
  351.  
  352.    The new font is a modified version of the ZyXEL's ZFAX font.  These
  353.    fonts were added because many users claimed the original font (/F0)
  354.    was too ugly.  A font editing program (FNTEDIT.EXE) is included for
  355.    users who wish to customize the two BGFAX fonts.  The included font
  356.    file is a standard American/English/ASCII 256 character set.
  357.  
  358. Notes
  359. ~~~~~
  360. 1. This version of BGFAX no longer includes the drop-dead expiration
  361.    date that previous versions of BGFAX used.  However, to give people a
  362.    little incentive to register BGFAX, the fax "music" can no longer be
  363.    disabled, except on registered versions.  (The /NS switch).
  364.  
  365. 2. BGFAX will now show you bad command line parametered entered, or bad
  366.    BGFAX.CNF lines.  It will require you to press any key if it encounters
  367.    such a thing.  (READ THIS AGAIN!)        ^^^^^^^^^^^^^
  368.  
  369. 3. US ROBOTICS users: If you are using a NON-V.34 Courier, be sure to add
  370.    the /OU switch (old USR) on the command line when SENDING FAXES.  (Do
  371.    NOT do it on RECEIVING faxes, UNLESS you are using 09/20/93 firmware on
  372.    the V.32-TERBO Courier).  In review:
  373.  
  374.    Modem (US Robotics)        Sending  Receiving
  375.    ---------------------------------------------
  376.    USR v.32terbo (09/20/93)   /OU      /OU
  377.    USR v.32terbo (non 09/20)  /OU      n/a
  378.    *USR v.FC                  /OU      n/a
  379.    USR v.34 (latest FLASH)    n/a      n/a
  380.  
  381.    *If you are using the USR v.FC Courier, you should really get the
  382.    FLASH upgrade to turn your modem into the v.34 Courier.
  383.  
  384. 4. If you were storing faxes in QFX format, and you receive a 2D-MR style
  385.    comes in, BGFAX would save it, but it would be unusable because Quick
  386.    Link II does not support 2D-MR style faxes.  Now, BGFAX will automatically
  387.    shift to ZFAX file format in the event this occurs so that you will get
  388.    a usuable fax file out of the connection.
  389.  
  390. 5. BGFAX /SEND mode now has the "makefax" utility built into it.  What??
  391.    Well, before, in the release version of BGFAX 1.30, it would shell to
  392.    MAKEFAX.EXE to construct the top of page header files.  Now, a shell is
  393.    no longer required, so it will build the header internally.
  394.  
  395. New Command Line Switches
  396. ~~~~~~~~~~~~~~~~~~~~~~~~~
  397. 1. For people have timing problems in /rear end mode (i.e., they can
  398.    receive some faxes when using /FCOS and others using /FCO, but each
  399.    switch only works in certain circumstances), you can now optionally
  400.    control the timing aspects of BGFAX:
  401.  
  402.    /FCO and /FAST can now optionally be used as...  /FCO:nn or /FAST:nn
  403.        /FCO:4   will assume after 4 seconds that the "OK" already received
  404.        /FAST:7  will assume after 7 seconds that the "OK" already received
  405.  
  406.    /FCO:0 is functionally equivilant to /FCOS
  407.    /FAST:0 is functionally equivilant to /FCON
  408.  
  409.    /FCO will default to /FCO:20
  410.    /FAST will default to /FAST:20
  411.  
  412. 2. Added /ED switch on BGFAX command line.  /ED will make BGFAX use the
  413.    European date format (dd-mm-yy instead of USA format, mm-dd-yy) when
  414.    writing to log files.
  415.  
  416. 3. New command line parameter for /HOST and /RING modes.  /DTE:nnnnn which
  417.    force BGFAX to use the DTE specified, overring the SP= entry in the
  418.    BGFAX.CNF file.  Ex:  BGFAX /RING /DTE:57600
  419.  
  420. 4. If you were using a version of the Supra fax modem and were trying to
  421.    use in to answer calls in Class 1 mode instead of Class 2 mode, and
  422.    if you were getting +FCERROR messages, you might want to try the new
  423.    /DW switch on the BGFAX /HOST command line.
  424.  
  425. 5. New operation mode:   /RING
  426.      Example: BGFAX /RING
  427.    This is basically a modified version of /HOST mode.  In /HOST mode,
  428.    BGFAX waits for a "RING", then answers the phone.  In /RING mode,
  429.    BGFAX will go into a /HOST-like mode, but will initialize the modem,
  430.    and then immediately send the answer string to the modem.  What's the
  431.    reason for this?  Some people have written their own programs which wait
  432.    for a "RING" (or ring-status-indicator) that take up much less CPU
  433.    resources than CPU-hog BGFAX /HOST.  A DTE speed is o
  434.  
  435. 6. New command line parameter: /HB    ( for developers only )
  436.    /HB means that an ASCII banner file (BGFAX.H$$) already exists.  BGFAX
  437.    will then turn that into another temporary file BGFAX.HH$ (fax image
  438.    file).  You should not really need to mess with this.  If you don't use
  439.    this switch, BGFAX will construct its own ASCII banner file (using the
  440.    template information out of the config file), and then make the temp
  441.    fax image file.  Confused?  Top of page banner options:
  442.       /NB -> no top of page banners
  443.       /XB -> assume fax image banner file already exists (BGFAX.HH$)
  444.          (to use the /XB switch you must use MAKEFAX.EXE in /HDR mode)
  445.       /HB -> assume ASCII banner file already exists (BGFAX.H$$)
  446.    Again, the /XB and /HB switches are really for developers who want
  447.    to have complete control over what goes onto the top of the page.
  448.  
  449. Bugs Fixed
  450. ~~~~~~~~~~
  451. 1. Believe I have fixed a major bug with BGFAX when in /SEND mode, when
  452.    using a Class 1 modem.  BGFAX 1.30 would never get an acknowledgement
  453.    from the remote machine.  This was because BGFAX was "filling" the EOL's
  454.    in the RTC sequence.  Don't worry if you don't know what that means, but
  455.    it was a major problem that's now fixed.  BGFAX users using /SEND mode
  456.    with a Class 2 or Class 2.0 modem should notice no change.
  457.  
  458. 2. I documented something in BGFAX 1.30, that actually was not added.  :-)
  459.    Well, now it will work.  If you are using BGFAX in /HOST mode, BGFAX.DOC
  460.    said that you could specify a filename on the LO= or DO= line.
  461.    Actually, it was only working on one of the lines.  There was also a
  462.    typo in the BGFAX.CNF file included with BGFAX 1.30.  There was mention
  463.    of a ";lo=<load>" when it should have been ";do=<load>".
  464.  
  465. 3. Fixed problem with "crashmail".  (If you aren't running the GT Power
  466.    BBS netmail software, you don't have to worry about this.)  BGFAX was
  467.    not exiting with the correct errorlevel when a CQCQCQ crash string was
  468.    detected (as specified in the BGFAX.CNF file).
  469.  
  470. 4. Rockwell modems that are configured to report DCE rates on the CARRIER
  471.    line (i.e, CARRIER 28800, CONNECT 57600/ARQ) will now get properly
  472.    reported by BGFAX.
  473.  
  474. 5. Had a user call me with a problem they were having with their USR
  475.    Sportster 2400 data/9600 fax modem.  BGFAX kept thinking they were
  476.    using a Class 2 modem since it reported "(0,1)" instead of "0,1" on
  477.    an +FCLASS=? request.
  478.  
  479. 6. GVC recently came out with a new firmware revision to fix a problem
  480.    with their modem adaptive answering incorrectly reported 2400 data
  481.    callers as fax.  However, they broke something new in this release.
  482.    At the end of the page, when BGFAX sends its AT+FDR command, for some
  483.    reason, the modem would echo "AT+FDR+FHNG:0" as its response instead of
  484.    "AT+FDR" on one line, and then "+FHNG:0" on another.  Fixed BGFAX so
  485.    that it can handle the GVC's strange new behavior.
  486.  
  487. 7. In /HOST mode, if BGFAX encounters a "NO CARRIER" when trying to answer
  488.    a data call, it will now promptly abort instead of having to timeout.
  489.  
  490. 8. That silly BGFAX.DAT file that always pops up... Well, you can now
  491.    delete it and it will stay away.  BGFAX.DAT is now used ONLY in /HOST
  492.    mode, the way it was really meant to be used for.  (The BGFAX.DAT file
  493.    was never intended to exist in /Fxxx, /SEND, /INIT or /RING mode.)
  494.  
  495. ##############################################################################
  496.  
  497. Changes between BGFAX 1.30 and BGFAX 1.21                    SAT 11 JUN 94
  498. =========================================                    =============
  499.  
  500. BGFAX is available by Fido FREQ at 1:106/400 under the magic name "BGFAX".
  501. It is also available off FTP site FTP.CSN.NET in the "Computech" directory.
  502.  
  503. The expiration date has been extended from June 30 until September 30, 1994.
  504.  
  505. Top of page headers
  506. ~~~~~~~~~~~~~~~~~~~
  507.    BGFAX will now add top of page headers on all pages when SENDING
  508.    facsimiles.  Consult BGFAX.DOC for more information.  Be sure to add the
  509.    following two lines into your BGFAX.CNF file if you send faxes:
  510.  
  511. fh=To: %to21% From: %fr42% %mo2%/%dy2%/%yr2%  %hr2%:%mi2%  Pg %pg2%/%mp2%
  512. fr=B.J. Guillot (713-893-9124)
  513.  
  514.    You will need to place the new copy of MAKEFAX.EXE included with BGFAX
  515.    1.30 as well as the BGFAX.FNT font file in your BGFAX directory.
  516.  
  517.    The fh= is the top of page header template.  See BGFAX.DOC for more
  518.    details.  The fr= is to be your company/personal name to go into the
  519.    %frNN% template variable.  Example:
  520.  
  521.       bgfax /send output.fax 555-1212
  522.  
  523. To: 555-1212              From: B.J. Guillot (713-893-9124)                05/08/94  16:25  Pg 01/15
  524.  
  525.    Keep in mind the above line is 100 characters long.  Another example,
  526.    this time using the new /FR and /TO override switches:
  527.  
  528.       bgfax /send output.fax 555-1212 /fr=BGFAX_Tech_Support /to=John_Doe
  529.  
  530. To: John Doe              From: BGFAX Tech Support                         05/08/94  16:25  Pg 01/15
  531.  
  532.    A few other new switches relating to the top of page headers are
  533.    available.  You generally should not have to use any of these, but I
  534.    like to keep everything in BGFAX documented:
  535.  
  536.    /NB    do not put headers on pages (IT IS AGAINST UNITED STATES AND
  537.           CANADIAN FEDERAL LAW TO USE THIS SWITCH)
  538.    /XB    assume top of page temporary file has already been created and
  539.           use existing temp file instead of creating a new one (THIS IS FOR
  540.           TESTING PURPOSES ONLY)
  541.    /HDR   an interal switch for MAKEFAX.EXE (DO NOT USE)
  542.  
  543. Two Dimensional Fax Compression
  544. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  545.    Put support in BGFAX for sending and receiving 2-dimension (Modified
  546.    Read) fax documents.  What are 2d faxes?  It's basically a different
  547.    compression method for the fax images.  2d faxes are generally about 12%
  548.    smaller (size in bytes) than standard (1-dimension, Modified Huffman)
  549.    faxes.  To enable 2d fax reception on a Class 2 fax modem, make sure
  550.    your +FDCC=1,5,0,2,1,0,0,0.  (Notice the "1" after the "2".  Usually I
  551.    tell people to put FOUR zeros on the end, now it's only three.)  Note
  552.    that VIEW.EXE cannot yet view 2D faxes, so if you want to use this
  553.    feature, you must use ZFAX to view them.  :-).  The 2D option was mainly
  554.    added for people with ZyXEL modems that always defaulted to 2D fax.  If
  555.    BGFAX didn't know the incoming fax was 2D, it would corrupt it in the
  556.    process of receiving it.  Now, if it notices it's 2D, it will put the
  557.    proper flags in the ZFAX fax file.
  558.  
  559.    Note that the QuckLink II QFX format does not have a field for 2D fax
  560.    identification.  As a result, if you wish to receive these better
  561.    compressed fax files, be sure to tell BGFAX to save faxes in ZFAX mode.
  562.  
  563. Other new features
  564. ~~~~~~~~~~~~~~~~~~
  565. 1. VIEW.EXE now checks for the type of graphic adapter card you are using
  566.    (VGA, EGA, CGA) and will automatically select the correct mode.  You will
  567.    no longer need to use the /EGA and /CGA switches.  VIEW currently does
  568.    not view 2D compressed fax files.  I'm working on this.
  569.  
  570.    Many people complained that VIEW's Alt-S (zoom out, squeeze) function
  571.    kept resetting to normal full zoom mode when an arrow key was it.  VIEW
  572.    was actually designed that way :-), but so many people complained, I
  573.    made a change.  Now, when you enter Alt-S zoom out mode, it will STAY in
  574.    zoom out mode until you hit Alt-S again, or, jump to another page in the
  575.    fax file you are viewing.  Note that Alt-S will not stick in CGA video
  576.    mode.  Therefore, only EGA and VGA video modes will be support Alt-S
  577.    zoom out mode.  (CGA systems can still do it, it just won't "stick").
  578.  
  579.    Made a change in VIEW so that Windows 3.1 Accessory "Paintbrush" can
  580.    now correctly read VIEW filename /PCX created PCX files.  PCX files can
  581.    also be read by CSHOW, PCXview 1.12 and ZFAX 2.23.  Therefore, since
  582.    four programs can do it, the PCX files should be readable by anything.
  583.  
  584. 2. BGFAX will now disconnect if the remote fax machines does not meet
  585.    BGFAX's requirements for the current session.  (i.e., if you are trying
  586.    to send a high resolution fax to a non-high res station, BGFAX will
  587.    abort, as well as if you try to send a 2D-MR fax to a 1D-MH only
  588.    station.  Before, BGFAX would alert the user of the mismatch, but still
  589.    send the fax, which would result in either elongated or garbage faxes on
  590.    the receiving end.)
  591.  
  592.    If you are sending in /ER mode, these new errorlevels have been added:
  593.  
  594.       errorlevel 17 -> remote fax device does not support 2D-MR
  595.       errorlevel 16 -> remote fax device does not support high resolution
  596.       errorlevel 15 -> Class 1 fail after connect (similar to errorlevel
  597.                        12, except 12 is for Class 2/2.0 only)
  598.  
  599. 3. Some people were having trouble with the 30 digit maximum phone number
  600.    in /SEND mode, now, the phone number can be up to 60 digits (so you can
  601.    get through those nasty PBX'es, etc.)
  602.  
  603. 4. A new MAKEFAX.EXE is included with this release.  MAKEFAX will now start
  604.    a new page if a ^L (ascii-12) is encountered as the first character of
  605.    the line in an ASCII file.  MAKEFAX will now default to look for the
  606.    BGFAX.FNT file in the BGFAX environment path instead of the current
  607.    directory.  New MAKEFAX switches: /HDR, /HR, /2D, /SP
  608.  
  609.    /HR tells BGFAX to output a high resolution fax image file.  Note that
  610.      the font BGFAX uses is very simple and you will get NO advantage using
  611.      this option.  The disadvantage is it takes twice as long to send the
  612.      fax since all the scan lines have been duplicated.  Don't use.
  613.    /2D tells MAKEFAX to output a 2D-MR fax image.  While normally a 2D-MR
  614.      fax will will have better compression than standard fax files, MAKEFAX
  615.      does not yet know how to use 2D-MR's special compression, so you will
  616.      wind up with a fax file BIGGER than normal.  Don't use.
  617.  
  618.    BY THE WAY... MAKEFAX.EXE now requires TWO filenames when you call it.
  619.    The input filename and the output filename.  (In previous versions of
  620.    BGFAX, MAKEFAX would always create a file called OUTPUT.FAX.  Now, you
  621.    have to give it a name).  Example:
  622.  
  623.          MAKEFAX batman.txt robin.fax
  624.  
  625.    ...that would convert the ASCII text file "BATMAN.TXT" into a standard
  626.    fax format file, "ROBIN.FAX".
  627.  
  628.    The one switch that will be useful to you is /SP, which stands for
  629.    "short pages".  Using this switch will make your fax files smaller (if
  630.    they don't take up a full page).  Note that if you send to a thermal fax
  631.    machine, they will receive your fax, but the auto-paper cutters will cut
  632.    the page right after the last line of text, so it's possible they could
  633.    get a 8.5 x 2" paper instead of 8.5 x 11".  :-)
  634.  
  635. 5. Some /HOST mode changes.  In the BGFAX.CNF, if your LO= entry
  636.    (usually says lo=Please wait while the BBS loads...) has an actual
  637.    filename, like:
  638.  
  639.       lo=c:\banner.txt
  640.  
  641.    ...BGFAX /HOST mode will send that file across to the user.
  642.  
  643.    Also, added a new /300 switch that will allow BGFAX to take 300 bps data
  644.    callers.  Normally, a "CONNECT" message will be interpreted by BGFAX to
  645.    be a Class 1-non adaptive answering fax connect response.  (So people
  646.    that don't have adaptive answering modems can use BGFAX as a stand alone
  647.    fax program rather than a data/fax frontend/rearend).  Now, if you use
  648.    /HOST /300, a "CONNECT" message will be interpreted as "CONNECT 300".
  649.  
  650.    BGFAX will now properly shift the port to 1200 or 300 bps if you are
  651.    using an ancient 2400 only data fax modem.  (i.e., like autobauding).
  652.  
  653.    When answering data calls in /HOST mode, 40 seconds seemed to short to
  654.    establish data calls in some foreign countries (where the connections for
  655.    the modem sometimes take 95 seconds to establish).  I now pushed the limit
  656.    up to 2 minutes.
  657.  
  658. 6. Added bu= entry in BGFAX.CNF.  This entry allows you to define a busy
  659.    string.  BGFAX will default to "ATH1M".  (This busy string is used if
  660.    when you tell /HOST mode to perform a "local login").
  661.  
  662. 7. The PID number can now be specifed in BGFAX.CNF.  What's the PID number?
  663.    It allows BGFAX to work better in a multitasking environment.  If you
  664.    have a "pi=4" in your BGFAX.CNF, the BGFAX temp file will be called
  665.    BGFAX4.$$$ instead of BGFAX.$$$ so that it won't cause any problems.
  666.    Log files will also have the PID appened to them, i.e., BGFAX4.LOG,
  667.    FAXIN4.LOG, etc.  Using the pi= in BGFAX.CNF is completly optional.
  668.  
  669. 8. If a timeout occurs during fax reception, previously BGFAX would just
  670.    leave the BGFAX.$$$ file on the drive, and it would get overridden
  671.    later.  Now, if the fax is bad, it will be renamed BADnnnn.FAX.  Where
  672.    nnnn is a sequential number.  Sometimes it is helpful to be able to
  673.    inspect these bad files.
  674.  
  675. 9. Added /Q (quiet) and /QQ (super quiet) modes.  "Quiet" not meaning
  676.    sound, but screen output.  In /Q mode, 90% of the screen output will be
  677.    suppressed.  Instead of the usual "beautiful" BGFAX screen, the only
  678.    things printed to the screen will be the bland output of the log file.
  679.    In /QQ mode, 99% of the screen output is supressed.  These features are
  680.    useful for people running BGFAX under DOS emulators and don't need time
  681.    wasted by having the emulators write to the screen.
  682.  
  683. Class 1 bugs fixed
  684. ~~~~~~~~~~~~~~~~~~
  685. 1. Fixed a bug in my Class 1 implementation relating to receiving of HDLC
  686.    frames.  If the modem responded "NO CARRIER" to an "AT+FRH=3" request, I
  687.    was assuming this meant the modem was not functioning correctly, when in
  688.    fact, it means that no carrier is CURRENTLY present, but if you send the
  689.    command again (AT+FRH=3) the modem will report "CONNECT", like it
  690.    should.
  691.  
  692. 2. Class 1 HDLC sent and received frames are now added to DEBUG.LOG and
  693.    Class 1 sent frames are also now displayed on screen.
  694.  
  695. 3. At the end of pages in Class 1 mode, BGFAX would send a response to the
  696.    other fax machine when sending and expect a reply.  However, many fax
  697.    machines do not see the first reply (they are busy form feeding the
  698.    thermal paper and cutting it) and BGFAX would abort.  Now, BGFAX
  699.    properly will send the end of page frames up to three times before
  700.    giving up on the fax machine.
  701.  
  702. 4. I have eliminated the /HW switch for Class 1 users.  Now, BGFAX will
  703.    send 500 nulls at the beginning of each page.  Apparently, this is what
  704.    Quick Link II fax was doing, and it looks successfully so far.
  705.  
  706. 5. Fixed some more major problems in Class 1 send mode relating to the
  707.    minimum scan line time.  BGFAX will now pad the fax scan lines with
  708.    "FILL" (nulls) for scan lines that have less bytes than the minimum
  709.    required per scan line.
  710.  
  711. 6. Found a major bug in my Class 1 implementation.  Some people have
  712.    reported the problem as the "infinite retrain".  The problem had to do
  713.    with something I thought could be ignored--the minimum time per scan
  714.    line.  In Class 2, this setting is not important, but it appears to be
  715.    very important for Class 1.  Basically, BGFAX was telling the remote end
  716.    that BGFAX could only support a maximum of 0 ms/scan line.  Only other
  717.    fax modems, and some super-high tech fax machines support this.  Most
  718.    fax machines use 10 ms/line or 20 ms/line.  BGFAX will now correctly
  719.    negoiate this parameter with the remote fax device.  (This bug was only
  720.    significant in /SEND fax mode, not receiving).
  721.  
  722. Class 2.0
  723. ~~~~~~~~~
  724. 1. A Class 2.0 modem could not be forced in Class 1 mode for /SEND mode
  725.    with the /C1 switch.  Fixed.
  726.  
  727. 2. Added /FCC switch for testing purposes with USR Class 2.0 modems.
  728.    On Class 2 modems, I can force a maximum speed of 9600 when sending if I
  729.    issue the command "AT+FDCC=1,3,0,2,0,0,0,0" before dialing.  I assume I
  730.    should be able to do this using Class 2.0 by issuing
  731.    "AT+FCC=1,3,0,2,0,0,0,0" but it doesn't work so well.  If you use the
  732.    /FCC switch, BGFAX just lets you see what is going on.
  733.    By the way, to set a maximum speed for BGFAX in sending mode, use
  734.    BGFAX /SEND:7200 filename.ext phonenumber        [for Class 1, 2]
  735.    BGFAX /SEND:7200 filename.ext phonenumber /FCC   [for Class 2.0]
  736.    Remember, it doesn't appear to work properly, though.
  737.  
  738. ZyXEL #B1+FCLASS=6
  739. ~~~~~~~~~~~~~~~~~~
  740. 1. Many people reported BGFAX "locking up" when the little spinner
  741.    (propeller) was on the screen.  BGFAX will now monitor the DCD line and
  742.    if carrier drops, it will promptly exit BGFAX.  This DCD check occurs
  743.    during both the "Syncronzing" and page receiving.
  744.  
  745. 2. The remote fax ID was always being reported as "Null Fax ID" even
  746.    though it was visible in brackets on the screen.  Fixed.
  747.  
  748.  
  749.