bin
                                    ---
            Documentation for version 1.0, on August 13th, 1991

                              by Bruno Costa



WARNING

  Although  this  program  is freely distributable (see COPYRIGHT below), I
would  appreciate  if  you  take the time to write me a line or two (E-Mail
please)  if  you  are  using  any of my programs or if you have any kind of
ideas  or  suggestions  (This is not too much to ask, is it?).  If you feel
particularly  generous,  I  would  like  to  receive a disk with any useful
programs you have written, preferrably with source.  Thanks!


DESCRIPTION

  Bin  is a program to convert a single-hunk Amiga executable into a binary
file.   It does that by using standard AmigaDOS functions (LoadSeg) instead
of  relying  on  the  actual  disk storage format.  It is mostly useful for
Assembly language programs that are to be used as bootblocks or as data for
C programs. It works both under WB1.3 and WB2.0.


OPTIONS

  usage: bin <input> <output>

  <input> is the standard AmigaDOS executable file.
  <output> is a binary representation of the code in <input>, without any
kind of header, trailer or special information embedded.


EXAMPLES

  to convert bblock executable to bblock.bin memory dump:
    bin bblock bblock.bin


BUGS

  None  known, but problems may arise if the input file does not follows
the exact expected format. Some tests have shown that the program seems to
detect correctly the invalid cases.


AUTHOR

  The  accompanying  program  and  this documentation were written by Bruno
Costa.  He can be reached in the following ways:

  E-Mail: bruno@brlncc.bitnet (InterNet)
          bruno@BRLNCC        (BitNet)

  Mail:   Bruno Costa
          Rua Almirante Guilhem 454/102 bloco 1
          Leblon - Rio de Janeiro
          RJ 22440
          BRAZIL


COPYRIGHT

  This program is copyrighted by Bruno Costa.  It may be freely distributed
if  and  only if the source code, the documentation and the executables are
provided  in  original form.  It may be included in Public Domain/Shareware
compilations,  like  the  one  organized  by  Fred  Fish, as long as just a
nominal fee is charged for each disk (no more than US$10 per disk), and may
also be uploaded to BBS's or network services like BIX and CompuServe.


DISCLAIMER

  The author makes no warranty of any kind with respect to this product and
explicitly  disclaims  any implied warranties of merchantability or fitness
for  any  particular  purpose.