-------------------------------------------------------
  Documentation for the BXP (Binary to Pascal+XX) utility
  -------------------------------------------------------

  BXP converts a binary file -- eg. MYFILE.ZIP -- into a text
  file.  The text file can be processed to restore the original
  binary file. This allows the sharing of binary files via text
  mediums such as BBS echoes & electronic mail. BXP uses an "XX"
  encoding scheme to offer an efficient 3-to-4 byte ratio.

  The text file produced by BXP is Turbo Pascal source code, so no
  special decoder is needed: The original binary file is recreated
  when the TP source is compiled & executed. The filename extension
  of the BXP-produced source code is PXS, and you can compile it
  without renaming by invoking TP as TURBO MYFILE.PXS.

  The syntax for invoking BXP is "BXP [d:][path]<FileName>" where
  [d:] is an optional drive, [path] is the optional path, and
  <FileName> is the required file name of the input binary file.
  Wildcard naming, of the input file & path, may be used to save
  typing or process multiple files. BXP writes PXS file(s) to the
  current directory & path by default.

  Example: to encode the binary file MYFILE.ZIP you would type ...
    BXP MYFILE.ZIP
  ... which will create MYFILE.PXS on the default disk & directory.

  BXP encoding can be aborted by tapping a CTRL key. BXP also aborts
  upon any file i/o error.

  BXP supports output redirection and piping. You may redirect BXP
  output to any valid DOS device or file:
  * To see how many lines of TP source code will be created from
    file MYFILE.ZIP, without producing any actual disk output...
      BXP MYFILE.ZIP > NUL
  * To append the output of BXP to any existing text file, such as
    REPLY.TXT ...
      BXP MYFILE.ZIP >> REPLY.TXT
  * To view BXP output, with paging, just "pipe" to MORE (there's no
    output to your disk) ...
      BXP MYFILE.ZIP | MORE

  BXP isn't a bulk file encoder: BXP is intended for modest-sized
  binary files, for BBS posting, no larger than approximately 44k.
  Larger files will be denied. The size of the original binary file
  can be seen in the BXP-output TP source code BlockWrite function.

  You should avoid files which encode into more than the reasonable
  /normal size of one message. Posting of any encoded files must be
  done only if allowed by the Network and conference host, and only
  in moderation in all cases.

  ALWAYS compress any file(s) before encoding & posting using BXP --
  this will minimize bandwidth and add transmission error detection.

  BXP is free/no-charge to all.  No one may profit ($$$) by BXP.

  Current version, as of Aug.03.1994, is 0.3a (BXP.COM = 2242 bytes).

  If you have problems with, or questions about, BXP please leave me
  a message in any of the popular BBS network Pascal conferences (eg.
  RIME TP), or e-mail me at the Internet or FidoMail address below.

  Greg Vigneault

  Internet(Greg.Vigneault@westonia.com)
  Fido(1:250/636)
  Millennium Technologies, Box 7169, Stn.A, Toronto, Canada M5W 1X8.