home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / utilities / bin.lzh / bin / bin.doc < prev    next >
Encoding:
Text File  |  1992-01-18  |  2.5 KB  |  81 lines
  1.  
  2.                                     bin
  3.                                     ---
  4.             Documentation for version 1.0, on August 13th, 1991
  5.  
  6.                               by Bruno Costa
  7.  
  8.  
  9.  
  10. WARNING
  11.  
  12.   Although  this  program  is freely distributable (see COPYRIGHT below), I
  13. would  appreciate  if  you  take the time to write me a line or two (E-Mail
  14. please)  if  you  are  using  any of my programs or if you have any kind of
  15. ideas  or  suggestions  (This is not too much to ask, is it?).  If you feel
  16. particularly  generous,  I  would  like  to  receive a disk with any useful
  17. programs you have written, preferrably with source.  Thanks!
  18.  
  19.  
  20. DESCRIPTION
  21.  
  22.   Bin  is a program to convert a single-hunk Amiga executable into a binary
  23. file.   It does that by using standard AmigaDOS functions (LoadSeg) instead
  24. of  relying  on  the  actual  disk storage format.  It is mostly useful for
  25. Assembly language programs that are to be used as bootblocks or as data for
  26. C programs. It works both under WB1.3 and WB2.0.
  27.  
  28.  
  29. OPTIONS
  30.  
  31.   usage: bin <input> <output>
  32.  
  33.   <input> is the standard AmigaDOS executable file.
  34.   <output> is a binary representation of the code in <input>, without any
  35. kind of header, trailer or special information embedded.
  36.  
  37.  
  38. EXAMPLES
  39.  
  40.   to convert bblock executable to bblock.bin memory dump:
  41.     bin bblock bblock.bin
  42.  
  43.  
  44. BUGS
  45.  
  46.   None  known, but problems may arise if the input file does not follows
  47. the exact expected format. Some tests have shown that the program seems to
  48. detect correctly the invalid cases.
  49.  
  50.  
  51. AUTHOR
  52.  
  53.   The  accompanying  program  and  this documentation were written by Bruno
  54. Costa.  He can be reached in the following ways:
  55.  
  56.   E-Mail: bruno@brlncc.bitnet (InterNet)
  57.           bruno@BRLNCC        (BitNet)
  58.  
  59.   Mail:   Bruno Costa
  60.           Rua Almirante Guilhem 454/102 bloco 1
  61.           Leblon - Rio de Janeiro
  62.           RJ 22440
  63.           BRAZIL
  64.  
  65.  
  66. COPYRIGHT
  67.  
  68.   This program is copyrighted by Bruno Costa.  It may be freely distributed
  69. if  and  only if the source code, the documentation and the executables are
  70. provided  in  original form.  It may be included in Public Domain/Shareware
  71. compilations,  like  the  one  organized  by  Fred  Fish, as long as just a
  72. nominal fee is charged for each disk (no more than US$10 per disk), and may
  73. also be uploaded to BBS's or network services like BIX and CompuServe.
  74.  
  75.  
  76. DISCLAIMER
  77.  
  78.   The author makes no warranty of any kind with respect to this product and
  79. explicitly  disclaims  any implied warranties of merchantability or fitness
  80. for  any  particular  purpose.
  81.