home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / mac / macb10.arc / SHOWMACB.TXT < prev   
Encoding:
Text File  |  1988-08-28  |  2.4 KB  |  65 lines
  1. SHOWMACB 1.0 -- Read/write MacBinary headers
  2.  
  3. SYNTAX
  4.      showmacb [-z|-a] input file [output file]
  5.           -z = remove first MacBinary header
  6.           -a = add dummy MacBinary header
  7.  
  8.      Show all MacBinary headers:
  9.           showmacb xyz.sit
  10.  
  11.      If there are two headers then to remove the first one:
  12.           showmacb -z xyz.sit new.sit
  13.      
  14.      If there is no header then to add one:
  15.           showmacb -a xyz.sit new.sit
  16.  
  17.  
  18. DESCRIPTION
  19.      Apple Macintosh terminal programs usually prepend a 128 byte header to 
  20.      binary files uploaded to other systems.  This header is called a 
  21.      MacBinary header.  It contains directory information such as date/time 
  22.      stamp and full file name of the file.  Unfortunately, Mac files on BBS 
  23.      systems sometimes have none, one, or more than one MacBinary header.  
  24.      Non-Mac programs that use Mac files sometimes refuse to process a file 
  25.      because of the incorrect number of MacBinary headers.
  26.  
  27.      Example 1:
  28.      GIF picture files uploaded from Macs have MacBinary headers but most 
  29.      non-Mac GIF viewers refuse to process such files because they cannot 
  30.      find the GIF header.
  31.  
  32.      Example 2:
  33.      The UNSIT program refuses to process StuffIt files unless it has 
  34.      exactly one MacBinary header.
  35.  
  36.      SHOWMACB reads a file and displays all MacBinary headers it can find.  
  37.      There are two options to manipulate MacBinary headers.  
  38.  
  39.      The -z option will copy the input file to the output file except for 
  40.      the first 128 bytes of the input file.  MacBinary headers are exactly 
  41.      128 bytes long so the output file should be a copy of the input file 
  42.      without the first MacBinary header.
  43.  
  44.      The -a option will write a dummy MacBinary header to the output file 
  45.      then copy the input file to output file.  This will add a MacBinary 
  46.      header to a file.
  47.  
  48.  
  49. LEGAL STUFF
  50.      Copyright 1988 Brian K. Uechi.  All rights reserved.
  51.  
  52.      DISCLAIMER:  No warranty of any kind is made with regard to this 
  53.      program.  The Author shall be not liable for errors contained herein 
  54.      or for incidental or consequential damages in connection with 
  55.      furnishing, performance, or use of this material.
  56.  
  57.      This program may be freely distributed as long as it is not sold or 
  58.      included as part of a commercial product.  
  59.  
  60.      Brian K. Uechi
  61.      2616-A Kalihi St.
  62.      Honolulu, HI  96819
  63.      GEnie:  B.UECHI
  64.      CompuServe:  72330,155
  65.