home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / wildcat / chgclr21.zip / CHGCLR.DOC next >
Text File  |  1993-08-21  |  10KB  |  210 lines
  1.                           ChangeColor (CHGCLR) 2.11
  2.                    (c) 1993 by UniNova Services Corporation
  3.  
  4. DESCRIPTION:
  5. ------------
  6. This program is designed to change color codes in Wildcat! 3.xx display
  7. files.  In it's second version, you may now use wildcards, and it can
  8. be run in a batch file.  This should make it significantly more useful
  9. than the earlier version.  It will not handle binary files, however.
  10.  
  11.  
  12. DISCLAIMER:
  13. -----------
  14. Your use of the CHGCLR executable ("the program" or "the software") implies
  15. that you agree to assume all responsibility associated with the use of
  16. the software.  No warranty, express or implied, is included with the
  17. software, and UniNova Services Corporation ("UniNova" or "the corporation")
  18. will not be held responsible for any damages resulting from your use of the
  19. software.
  20.  
  21.  
  22. ASSUMPTIONS AND CONVENTIONS:
  23. ----------------------------
  24. In this document, it is assumed that you have a basic handle on the use of
  25. your operating system.  It is also assumed that you are running under MS-DOS
  26. or a compatible variant.  (MS-DOS is a trademark of Microsoft Corporation.)
  27. If you are not familiar enough with DOS to move files about between directories
  28. and change your default directory, a few minutes with the DOS manual would be
  29. a wise investment.  It will help to understand the DOS PATH and DOS ERRORLEVEL
  30. topics, as well.  If you need assistance beyond what this manual and your DOS
  31. manual can provide, contact UniNova.  Technical support beyond installation
  32. is reserved for registered users only.
  33.  
  34. In this manual, syntax options in brackets [] are optional.  Therefore, with
  35. the specification of FILESPEC[.EXT], the filename is required, but the
  36. period and extension are optional.
  37.  
  38.  
  39. USAGE/SYNTAX:
  40. -------------
  41. Step One:  BACK UP THE FILES YOU PLAN TO MODIFY!  The program has been tested
  42. extensively, but any software can have unpredictable results when used on the
  43. diverse systems in use today.  Your best insurance against information loss
  44. (with this program and in general) is to have a recent backup.  If nothing
  45. else, copy the original files to a RAM disk - if all goes well, you can
  46. ignore them and they'll "go away" when you shut the computer off or reboot.
  47.  
  48. Step Two:  Change to the directory that contains the files you wish to modify.
  49.  
  50. Step Three:  Call the executable file from the command line, using this
  51. syntax:
  52.  
  53. [drive:][path]CHGCLR filespec[.ext] @origcode@ @newcode@
  54.  
  55. The options are:
  56.     [drive:] - if the CHGCLR.EXE file is not in the default directory
  57.                with the display files, and is on a separate drive, you
  58.                will need to specify which drive the CHGCLR.EXE file is
  59.                on.  This is not needed if the CHGCLR.EXE file is in a
  60.                directory that is part of the DOS PATH.                     
  61.       [path] - again, if CHGCLR.EXE is not in the default directory or
  62.                the DOS PATH, you will need to specify the path to the
  63.                CHGCLR.EXE file.
  64.     filespec - the file specification, including valid DOS wildcards if
  65.                you so desire.
  66.       [.ext] - a period and three letter extension are required if the
  67.                display files you are modifying have them.  Again, valid
  68.                DOS wildcards may be used.
  69.   @origcode@ - the original color code you want to change.  This must be
  70.                a valid Wildcat! color code consisting of the @ symbol,
  71.                two characters in the 0-9 or A-F range, and another @
  72.                symbol.  Case, however, is not significant, so the letters
  73.                a-f are acceptable.
  74.    @newcode@ - the new code you want to use in place of @origcode@.  Subject
  75.                to the same (non-case-sensitive) content restrictions as
  76.                @origcode@.
  77.  
  78. Step Four:  Examine report of the program.  It will list files as it handles
  79. them, and will exit with DOS ERRORLEVEL 0 if all goes well, or 1 if there is
  80. an error.  A brief syntax explanation if no command line arguments are given
  81. or if the first parameter is ?, /?, or -?.  You may wish to check the DOS
  82. ERRORLEVEL in a batch file if this is part of a door batch file or maintenance
  83. batch file.  (Use the IF ERRORLEVEL 1 command construct.)  The program will
  84. also report how many files it processed successfully.
  85.  
  86. Step Five:  After the program terminates, verify that the changes are
  87. correct.
  88.  
  89.  
  90. SYNTAX EXAMPLES:
  91. ----------------
  92. Example One - CHGCLR.EXE is on a floppy in drive A.  You want to change all
  93. bright yellow (@0E@) in all HELLO files to bright green (@0A@):
  94.  
  95. A:\CHGCLR HELLO*.BBS @0e@ @0a@
  96.  
  97. Example Two - CHGCLR.EXE is either in the current directory or in a directory
  98. that is part of the DOS PATH.  You want to change the cyan (@03@) in the
  99. bulletin menu to green (@02@):
  100.  
  101. CHGCLR BULLETIN.BBS @03@ @02@
  102.  
  103. Example Three - You're a rare user who decides to register:
  104.  
  105. CHGCLR /reg
  106.            
  107.  
  108. REGISTRATION:
  109. -------------
  110. Starting with version 2.00, the program is now owned by UniNova Services
  111. Corporation, and a registration fee is required for a continued license
  112. to use the program.  This shareware concept is quite simple:  If you try it
  113. and decide to continue using it, you pay for the program; otherwise, delete
  114. the program.  There is no specific evaluation time - you will know when you
  115. are relying on the program, and you'll know if you're cheating the system.
  116. The price is intentionally kept low (basic $5 per copy) to encourage users
  117. to register; however, the corporation is not so naive to think that most, if
  118. any, users will actually register. (The corporation understands that Wildcat!
  119. Sysops often get "nickel-and-dimed to death" by the registration fees for add-
  120. on programs, so it will be something of a surprise if anyone registers this   
  121. software.)
  122.  
  123. The registration fee will obtain for you the most recent version of the
  124. registered edition of the program.  The only difference is that the registered
  125. version does not say "UNREGISTERED"; the corporation felt that limiting the
  126. shareware version would be an unnecessary annoyance to users.  Registration
  127. is also required for technical support beyond help with installation.
  128.  
  129. Users registering in Washington State must add sales tax to the $5/copy fee.
  130. Site licenses covering more than 9 copies are available for $48; site licenses
  131. are available for schools, government agencies, non-profit organizations, and
  132. commercial enterprises only.
  133.  
  134. To register, simply print the REGISTER.DOC form included with the program; as
  135. an alternative, run the program with the first (and only) parameter of /REG
  136. (not case sensitive), and the program will generate a registration form for
  137. you after a brief question-and-answer session.
  138.  
  139.  
  140. DISTRIBUTION PRIVILEGES:
  141. ------------------------
  142. You may freely make copies of this software, upload it to bulletin boards,
  143. give copies to friends, sell copies to enemies, etc., IF, and ONLY if:
  144.  
  145.     a)  You are distributing the SHAREWARE version of CHGCLR.EXE, and NOT
  146.     the registered version;
  147.     b)  You distribute the CHGCLR.DOC and REGISTER.DOC files IN THE SAME
  148.     ARCHIVE as CHGCLR.EXE;
  149.     c)  You make NO ATTEMPT to remove credit for the program from the
  150.     copyright owner (UniNova);
  151.     d)  You ATTEMPT to explain to the recipient that they do not own the
  152.     software, but only have a temporary license to evaluate it, as defined
  153.     by the shareware concept described herein under "REGISTRATION";
  154.     e)  You charge NO MORE than $10 to the recipient for access to, and
  155.     only to, this program.  (Therefore, if you are charging them $2000 for
  156.     a computer system, no more than $10 of that $2000 can be listed as the
  157.     cost of obtaining an evaluation copy of this software.  Similarly, if
  158.     you charge callers $50 annually to use your BBS, you cannot charge more
  159.     than $10 for the specific purpose of downloading this program.)  Just
  160.     because some people are fools does not mean you should take advantage...
  161.  
  162.  
  163. CONTACTING THE AUTHOR:
  164. ----------------------
  165. You may write to the author at:
  166.         UniNova Services Corporation
  167.         ATTN:  ChangeColor
  168.         PO Box 900
  169.         Ellensburg,  WA    98926
  170.  
  171.  
  172. HISTORY:
  173. --------
  174. 2.11    - Changed filename display.
  175. 2.10    - Changed the query about continuing with multiple file processing
  176.           after encountering an error to make the default answer "Y" and
  177.           to assume that default after approximately 15 seconds to allow
  178.           use in a batch file without the danger of hanging up the batch
  179.           file while waiting for user input.
  180.                                                                             
  181. 2.00    - Added wildcard / multi-file support.                              
  182.         - Changed to command-line arguments for use in batch files.
  183.         - Began "requiring" registration fees for continued use.
  184.         - Re-written in C++.
  185.         - Released as the copyright property of the new owner, UniNova
  186.           Services Corporation.
  187.                                                                              
  188. 1.0     - Original release.
  189.         - Written in Modula-2.
  190.         - Released as the copyright property of Stuart J. Whitmore.
  191.  
  192.  
  193. ABOUT THIS MANUAL:
  194. ------------------
  195. This manual was written in a brief form to save disk space and file transfer
  196. time.  If you feel it could be significantly shorter, please contact the
  197. author as shown above.  If you decide to print this manual, please recycle
  198. the paper you print it on after you no longer need the manual.
  199.  
  200.  
  201. ABOUT UNINOVA SERVICES CORPORATION:
  202. -----------------------------------
  203. UniNova is dedicated to advancing technology to serve humanity.  To that end,
  204. it actively engages in research and development in diverse areas.  If you would
  205. like to learn more about the company, even if you do not desire to register
  206. this software (whether or not you're using it), feel free to write to the 
  207. address shown above, less the ATTN line.  Shareware utilities such as this are
  208. not the main focus of the corporation, but serve to meet short range goals 
  209. that lead to greater research and development capabilities in the future.
  210.