home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / deboo100.zip / MAKEBOO.DOC < prev    next >
Text File  |  1993-05-28  |  4KB  |  92 lines
  1. HISTORY
  2. -------
  3.  
  4. [1]  Original by Bill Catchings, Columbia University, July 1984
  5.  
  6. [2] DOS Version adapted from the DEC-20 code to run on Lattice-C (v 2.14)
  7.   on an IBM PC/AT under DOS 3.0.      Alan Phillips, Lancaster University UK
  8.  
  9. [3] OS/2 2.x version adapted from Alan Phillips' code to run on 386/386
  10.     PCs running OS/2 by Dr. Abimbola Olowofoyeku, Keele University,
  11.     England, U.K. (May 1993).
  12.  
  13.     An interactive mode has been added by me to cope with cases in which
  14.     there are insufficient/inappropriate/no command line parameters.
  15.  
  16.     Compiled with EMX/GCC. The code has been amended to compile on any
  17.     ANSI compatible C compiler. The modified code has been compiled
  18.     without any changes on UNIX platforms with the Dynix C compiler,
  19.     and with the GNU C compiler. The amended source is available for those
  20.     who want it. Mail me: laa12@uk.ac.keele.seq1 (JANET).
  21.  
  22.     The OS/2 version requires the EMX libraries (EMX.DLL and EMXLIBC.DLL)
  23.     for system calls. Both DLLs are supplied with the executables.
  24.  
  25.  
  26. DOCUMENTATION (taken from the original C source code, and slightly edited)
  27. --------------------------------------------------------------------------
  28.   This program takes a file and encodes it into printable characters.
  29.   The idea behind this is similar to that which led to the production
  30.   of UUENCODE. The BOO encoding is comparable. The file is encoded by taking
  31.   three consecutive eight bit bytes and dividing them into four six bit
  32.   bytes.  An ASCII zero was then added to the resulting four characters.
  33.   to make them all printable ASCII characters in the range of the
  34.   character zero to the character underscore.   In order to reduce the
  35.   size of the file null repeat count was used.  The null repeat count
  36.   compresses up to 78 consecutive nulls into only two characters.  This
  37.   is done by using the character tilde (~) as an indication that a group
  38.   of repetitive nulls has occured.  The character following the tilde is
  39.   number of nulls in the group.  The number is also converted in to a
  40.   printable character by adding an ASCII zero.  The highest number of
  41.   nulls is therefore the highest printable character tilde.  This is
  42.   equal to tilde minus zero nulls or 78 nulls.  Because of the three
  43.   byte to four byte encoding the repeat counting can only start with
  44.   the first character of a three byte triplet.
  45.  
  46.  
  47. USAGE
  48. -----
  49.   The best use for the BOO encoding is to send binary files by email.
  50.   First archive the binary files, using ZIP, ZOO, LHARC, etc., and
  51.   then run MAKEBOO on the archived file.
  52.  
  53.   The syntax is MAKEBOO <inputfile> <outputfile>
  54.  
  55.   If no parameter is supplied, or if only the input file is supplied,
  56.   the program will switch into an interactive mode and request the names
  57.   of the input file, and output file.
  58.  
  59.   Example:
  60.        MAKEBOO TEST.ZIP TEST.BOO (encode test.zip into test.boo)
  61.  
  62.  
  63.   NOTE: there is a bug built into the EOF handling which causes the
  64.   output file to grow everytime a file is packed/unpacked.  This is
  65.   because 2 nulls and a space are added at the end of each run.  As
  66.   the data is past the end of the file, it does not affect the program
  67.   produced.
  68.  
  69.  
  70.   DISLCAIMER
  71.   ----------
  72.   I am trying to provide OS/2 users with a service by porting this
  73.   utility to OS/2 and sending it to ftp sites. I DO NOT WARANTEE
  74.   ANYTHING about this program. I accept no responsibility for ANY LOSS OR
  75.   DAMAGE, financial, physical, emotional, marital, OR OTHERWISE resulting
  76.   FROM THE USE, OR THE PURPORTED use of MAKEBOO for OS/2, for any purpose
  77.   whatsoever. You use this program ENTIRELY AT YOUR OWN RISK.
  78.  
  79.   If you do not like this disclaimer, then you are requested to please
  80.   DELETE ALL THE FILES from your disks IMMEDIATELY.
  81.  
  82.  
  83. -------------------------
  84.   Dr. Abimbola Olowofoyeku
  85.   School of Law
  86.   Keele University,
  87.   England
  88.  
  89.   Email: laa12@uk.ac.keele.seq1
  90.  
  91.  
  92.