home *** CD-ROM | disk | FTP | other *** search
/ The Unsorted BBS Collection / thegreatunsorted.tar / thegreatunsorted / misc / ac.doc < prev    next >
Text File  |  1991-06-13  |  2KB  |  51 lines
  1. AC.COM  -  AddComment       Version 1.01                  Released: Jun-13-91
  2. Copyright (C) 1991          Larry Wood  and  Tom Potocki
  3.  
  4. AddComment takes an ASCII text file and adds it to one or more GIF87a or
  5. GIF89a data stream files as a GIF89a Comment Extension Block. The resulting
  6. file(s) will be a GIF89a data stream.
  7.  
  8. AC requires 2 paramaters on the commandline. The first may be a path/filename
  9. or directory name, with wildcards supported. The extension .GIF is appended to
  10. filenames if no extension is supplied. To defeat this, end the name with a
  11. period "."   Example: C>AC GALLAD GAL looks for GALLAD.GIF and C>AC GALLAD. GAL
  12. looks for GALLAD.  (GAL is extended to GAL.TXT as the textfile name)
  13.  
  14. The second paramater must be a path/filename. This file is expected to be an
  15. ASCII text file. The text will be added, as a GIF89a Comment Extension Block,
  16. to the file(s) specified by the first paramater in the commandline.
  17.  
  18. The extension .TXT is appended to this filename if no extension is supplied.
  19. To defeat this, end the name with a period ".".
  20.  
  21. If the second paramater is not a pathname, but only a filename, it's default
  22. directory is assumed to be the same as the directory of the first paramater.
  23.  
  24. AC assumes the GIF file is a valid GIF data stream, with no leading or trailing
  25. bytes. No Error checking at all is done on the data stream. Use QCHK on all
  26. files to be modified by AC to avoid problems.
  27.  
  28. Example commandlines:
  29.  
  30. C>AC C: GAL
  31.   This will add the text in GAL.TXT, in the default directory of drive C, to
  32.   all *.GIF files in the default directory of drive C.
  33.  
  34. C>AC D:\DYAN GNET
  35.   This will add the text in D:\DYAN\GNET.TXT to all *.GIF files in the \DYAN
  36.   directory of drive D.
  37.  
  38. C>AC D:\DYAN B:GNET
  39.   This will add the text in GNET.TXT, in the default directory of drive B, to
  40.   all *.GIF files in the \DYAN directory of drive D.
  41.  
  42. C>AC D:\DG*.GIF B:GNET.ASC
  43.   This will add the text in GNET.ASC, in the default directory of drive B, to
  44.   all .GIF files, begining with DG, in the root directory of drive D.
  45.  
  46. When AC modifies a file, it renames it with BAK as the extension and writes
  47. to a new file. Before doing so it checks for sufficient disk space. If not
  48. enough space is available the mod is aborted and a message telling same is
  49. issued. If all goes well the BAK file is deleted. If all does not go well the
  50. original file still exists but with BAK as its extension.
  51.