home *** CD-ROM | disk | FTP | other *** search
/ The Unsorted BBS Collection / thegreatunsorted.tar / thegreatunsorted / misc / rc.doc < prev    next >
Text File  |  1992-04-17  |  5KB  |  104 lines
  1. RC.COM  -  RemoveComment    Version 2.01b                           17-Apr-92
  2. Copyright (C) 1992    by    Larry Wood  and  Tom Potocki
  3.  
  4.  
  5. RC is a GIF89a data stream modification utility.  It removes, from GIF89a
  6. data dtreams, Comment Extension Blocks.
  7.  
  8. RC also provides an option for saving removed comment blocks to one or more
  9. disk files.
  10.  
  11. An optional switch, /F, provides a means to change the version of any GIF data
  12. streams  which no longer require a version of 89a  after removal of any GIF89a
  13. Comment Extension Blocks.
  14.  
  15. The optional switch, /FO, provides a means to change the version of any data
  16. streams which  are version 89a, but  should be version 87a because they have
  17. no data or extension blocks which require a version of 89a.
  18.  
  19. RC requires  one  paramater on the commandline. It can be a drive, directory,
  20. filename, or  combination, with wildcards supported. This paramater specifies
  21. the source  of the GIF data stream(s).  The extension .GIF is appended to the
  22. filename if no extension is supplied.  To defeat this, end the  filename with
  23. a period " . ".
  24.  
  25. Example:   C>RC PIRATE  looks for PIRATE.GIF
  26.            C>RC PIRATE. looks for PIRATE
  27.  
  28. -----------------------------------------------------------------------------
  29. ::WARNING::  RC modifies a data stream by OVERWRITING the source! Data stream
  30. files specified by the source paramater will be permanently changed, and any
  31. comment blocks removed will be lost... unless saved to a disk file.
  32. -----------------------------------------------------------------------------
  33.  
  34. RC's default filespec is *.GIF and this will be used if the source paramater
  35. on the commandline is a drive or directory.
  36.  
  37. Entering a second paramater, the destination, will result in RC writing the
  38. GIF89a Comment Extension Blocks to one or more disk files.
  39.  
  40. If the destination is a unique filename RC will write all comment extension
  41. blocks, from all source files, to this one file.
  42.  
  43. If the destination is not a unique filename, but a drive or directory, RC will
  44. write all comment extensions, from each source file, to a file having the
  45. same name as the source file. The default filename extension is TXT.
  46.  
  47. The default destination filename extension may be specified by using an
  48. asterisk, " * ", in place of the filename, in the destination paramater.
  49.  
  50. Example:   C>RC D:\PHOTOS *.CMT
  51.  
  52.            This will remove comments from all files in D:\PHOTOS having .GIF
  53.            as an extension, and write those comments to files, with the same
  54.            names, and with .CMT as the extentions. These files will be put
  55.            in the default directory of C drive.
  56.  
  57. GIF data streams which contain comment extension blocks are required to have
  58. a version number of 89a. If this version number is required only because the
  59. data stream contains a comment extension block, then it should be changed to
  60. 87a when all comment extension blocks are removed.
  61.  
  62. RC provides a switch, " /F ", for changing an 89a version number to 87a.
  63. Including this switch in the commadline will tell RC to "Fix" the version
  64. number of data streams which no longer require version 89a.
  65.  
  66. Including the " /FO " switch in the commadline will tell RC to "FixOnly"
  67. the version numbers of those data streams which it encounters that are
  68. incorrectly labeled version 89a.  It will  NOT  remove comments from data
  69. streams, but only change those that should be changed to version 87a.
  70.  
  71. Some example commandlines:
  72.  
  73. C>RC UTILITY
  74.   This will remove all comment blocks, from all GIF98a data stream files
  75.   having .GIF extensions, in the C:UTILITY directory. All comment blocks
  76.   will be lost.
  77.  
  78. C>RC UTILITY D:*.CMT
  79.   This will remove all comment blocks, from all GIF98a data stream files
  80.   having .GIF extensions, in the C:UTILITY directory. All comment blocks
  81.   in each data stream will be written to a file having the same name as the
  82.   source, and with .CMT as it's extension. These files will be put in the
  83.   default directory of D drive.
  84.  
  85. C>RC UTILITY D:*.CMT/f
  86.   This will remove all comment blocks, from all GIF98a data stream files
  87.   having .GIF extensions, in the C:UTILITY directory. All comment blocks
  88.   in each data stream will be written to a file having the same name as the
  89.   source, and with .CMT as it's extension. These files will be put in the
  90.   default directory of D drive.
  91.   All GIF89a source data streams which no longer require an 89a version
  92.   number will be changed to version 87a.
  93.  
  94. C>RC D:\NEW/fo
  95.   This will look at all files in the D:\NEW directory having .GIF extensions.
  96.   Those containing GIF89a data streams will be checked for the need to be
  97.   version 89a. Those that are found to not require an 89a version number
  98.   will be changed to version 87a.  No other modification is done.
  99.  
  100. At present, RC can work with GIF data streams which will fit in RAM. Those
  101. that are larger than available memory will be skipped.  Sorry!
  102.  
  103. Amen.
  104.