home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util1 / gsr13.lzh / GSR.DOC next >
Text File  |  1990-11-01  |  9KB  |  266 lines
  1.  
  2.  
  3.  
  4.                   GGGGGGGGGG      SSSSSSSSSS       RRRRRRRRR
  5.                   G        G      S                R        R
  6.                   G               S                R        R
  7.                   G               S                R        R
  8.                   G               SSSSSSSSSS       RRRRRRRRR
  9.                   G      GGG               S       R     R
  10.                   G        G               S       R      R
  11.                   G        G               S       R       R
  12.                   GGGGGGGGGG      SSSSSSSSSS       R        R
  13.  
  14.  
  15.  
  16.                     Global          Search          Replace
  17.  
  18.                                  Version 1.3
  19.  
  20.                            The Programmers Scalpel!
  21.  
  22.  
  23.                Copyright 1990 Phil Barnett. All Rights Reserved
  24.  
  25.  
  26. GSR and all of its' associated files are Shareware.
  27.  
  28. They are also Copyrighted. Please feel free to give this program to anyone
  29. who uses a DOS based computer as long as it is distributed in unmodified
  30. and complete form. It should work on any close clone. I developed it in 
  31. DOS 3.3 . It is compiled in Clipper 5.0. with MS-C6.0 subroutines for speed.
  32. It requires DOS version 3.0 or later.
  33.  
  34.  
  35.                  You may use GSR for 2 weeks at no charge. 
  36.  
  37.              Then if you wish to continue using GSR, you must 
  38.  
  39.                    PAY ME FOR IT    or    STOP USING IT.
  40.  
  41.  
  42. Registration fee is $20.00. I prefer to trust you, so no protection is
  43. involved. This is an absolutely complete version. Even if you don't use it,
  44. please give it to someone who programs
  45.  
  46.  
  47.                  ****************************************
  48.                  *   Phil Barnett      (407) 884-5192   *
  49.                  *   1105 Binion                        *
  50.                  *   Apopka, Fl 32703                   *
  51.                  ****************************************
  52.  
  53.  
  54. When you register this program I will send you the latest version which will
  55. have the registration notice and pause removed from the beginning of the
  56. program.
  57.  
  58.  
  59.  
  60.                       INSTALLATION INSTRUCTIONS
  61.  
  62.  
  63. You may place GSR in any directory, however it is easier to use if you
  64. place it in a directory which is in the path statement of your autoexec.bat.
  65.  
  66.  
  67. GSR includes three files.
  68.  
  69. 1      GSR.EXE        The Executable Program
  70. 2      GSRAVOID.DBF   A table of special extensions (explained below)
  71. 3      GSR.DOC        This Document
  72.  
  73.                !!!!!!!!!! IMPORTANT !!!!!!!!!!! READ THIS !!!!!!!!!!
  74.  
  75.         YOU SHOULD ALWAYS MAKE A BACKUP OF THE DIRECTORY YOU ARE WORKING IN 
  76.                              BEFORE YOU BEGIN WITH GSR.
  77.  
  78.         YOU SHOULD ALWAYS MAKE A BACKUP OF THE DIRECTORY YOU ARE WORKING IN 
  79.                              BEFORE YOU BEGIN WITH GSR.
  80.  
  81.         YOU SHOULD ALWAYS MAKE A BACKUP OF THE DIRECTORY YOU ARE WORKING IN
  82.                              BEFORE YOU BEGIN WITH GSR.
  83.  
  84.    Even though every precaution has been taken to insure it's safe use, the
  85.   potential for unrecoverable change exists in any program with this kind of
  86.     power. GSR even keeps the last 99 versions of what you are working on. 
  87.  
  88.  
  89.  
  90.  !!!!!!!!!!!!!!!!!!!!!!!!! ALWAYS make a backup first !!!!!!!!!!!!!!!!!!!!!!!!!
  91.  
  92.  
  93.  
  94.  
  95.                           Manual for GSR Version 1.3
  96.  
  97.  
  98. GSR is a Global Search and Replace program. It allows you to select a group
  99. of files to operate on. You can then specify what text to look for, and what
  100. text to replace it with. Your search can be either case sensitive or not,
  101. and you may either view each occurance, to verify the change, or have GSR
  102. automatically make all replacements for you.
  103.  
  104. Probable uses are:
  105.  
  106. Rename an existing variable across many programs.
  107. Change a copyright notice.
  108. Change a client name when you are recycling code.
  109. and many more.....
  110.  
  111. All options are entered into blanks after you run the program.
  112.  
  113. When you see the field labeled "File Spec to Include" you should enter the
  114. type of file you wish to perform global operations on. Typical response might
  115. be;
  116.  
  117. *.C
  118. *.PRG
  119. *.BAT
  120. *.BAS
  121. *.TXT
  122. XXX*.XXX
  123. and etc.
  124.  
  125. The next field you enter is 'String to Search for'. This is where
  126. you enter the text you are wishing to replace. If you need to replace text
  127. that is longer than 76 characters, or you wish to include carriage return
  128. linefeed combinations, you may use an input file instead. Place the filename
  129. in <> like this: <lookfor.txt> as the only item in the field.
  130.  
  131. (you can use any filename here, lookfor.txt is only an example)
  132.  
  133. The next field you enter is 'String to Replace with'. This is the
  134. text you wish to replace the above field with. You may also use an input file
  135. here by placing the replacement text in a file and specifying it's name
  136. in <> like this: <a:\repwith.txt> as the only item in the field.
  137.  
  138. (you can use any filename here, a:\repwith.txt is only an example)
  139.  
  140. Your next option is '(M)anual or (A)utomatic'. If you select automatic mode,
  141. the search and replace operation will complete without further intervention.
  142. If you are unsure of the consequences of this action at all, you should use
  143. manual mode instead.
  144.  
  145. Your last option is to make GSR search for your text regardless of the case.
  146. If you choose 'Case Sensitive' = 'N', capitalization will have no bearing on
  147. your search.
  148.  
  149. pHiL will find PHIL
  150. xxxxxx will find XXXXXX
  151. PHIL will find phil
  152. copyright 1990 will find Copyright 1990
  153. and etc.
  154.  
  155.  
  156. After you have entered the five primary fields, you will be presented with
  157. a summary screen of selections. This will allow you to review your choices
  158. and abort the process if you were mistaken in any way.
  159.  
  160. When you confirm the selections you have made, the search will begin. 
  161.  
  162. If you selected manual mode, each occurance of the searched for text will be
  163. displayed in context as it is found. You will be asked:
  164.  
  165. Replace this occurrance?  (Y/N)
  166.  
  167. If you select Y, it will be replaced, and the search will continue. If you
  168. select N, the search will continue with no changes to the file.
  169.  
  170. When you have reached the end of the file, and you have previously selected to
  171. replace an occurrance, you will receive one final prompt 
  172.  
  173. Replace Global Changes to this File?  (Y/N)
  174.  
  175. If you select Y, your changes will be written. If you select N, any changes you
  176. have already selected on this file will be ignored.
  177.  
  178. In any case, if you choose to make the replacements, your original text will
  179. be saved with the extension .GSR. Subsequent changes will increment the .GSR
  180. extension, with up to 99 changes kept on any single file name.
  181.  
  182. MYTEXT.GSR
  183. MYTEXT.GS1
  184. MYTEXT.GS2
  185. MYTEXT.GS3
  186. MYTEXT.GS4
  187. MYTEXT.GS5
  188. MYTEXT.GS6
  189. MYTEXT.GS7
  190. MYTEXT.GS8
  191. MYTEXT.GS9
  192. MYTEXT.G10
  193. MYTEXT.G11
  194. MYTEXT.G12
  195. MYTEXT.G13
  196. MYTEXT.G14
  197. MYTEXT.G15
  198.  
  199. up to 
  200.  
  201. MYTEXT.G99
  202.  
  203. 99 previous versions are kept until you choose to delete them. This is going
  204. to create a lot of backups, but is necessary due to the tremendous power of 
  205. this program to cross all safety barriers.
  206.  
  207. This process repeats for every file in the selected group.
  208.  
  209. During the replacement process you are informed of your location in the group
  210. of files you are operating on. When you have finished, you are presented with
  211. statistics informing you how many replacements were made and in how many files.
  212.  
  213.  
  214.  
  215.  
  216.  
  217.                                   GSRAVOID
  218.  
  219. Why it's here?
  220.  
  221. There are many types of files that any length text can be replaced with any
  222. other length, and never cause a problem. 
  223.  
  224. There are many files, however, that allowing a change like this would cause
  225. a disaster. For this reason, I included fifteen file extensions inside GSR
  226. that cannot be written to unless the search text and the replace text are
  227. identical in length.
  228.  
  229. GSR looks for the file GSRAVOID.DBF in the current directory, and if it finds
  230. it, GSR reads in file file extensions in GSRAVOID instead of using it's 
  231. internal list. 
  232.  
  233. This allows you to add to or override my fifteen extensions. 
  234.  
  235. The extensions I avoid internally are as follows.
  236.  
  237. .COM       .BAT       .EXE       .DBF       .DBT       .NTX       .NDX
  238. .OVL       .LIB       .OBJ       .MEM       .SYS       .ZIP       .ARC
  239. .PAK
  240.  
  241. Changing the length of any of these types of files would spell certain 
  242. disaster. You may add more if you wish by filling in more records in
  243. GSRAVOID.DBF with any dBASE type program. You do NOT need to put GSRAVOID.DBF
  244. in a directory for GSR to work. It only exists so you can override my defaults.
  245.  
  246.  
  247.  
  248. WARNING!
  249.  
  250. DISCLAIMER:
  251.  
  252. You are totally responsible for the use of this program. If it causes damage
  253. of any kind, you are responsible. In no way will I, Phil Barnett, assume any
  254. expense or provide any compensation for the use or misuse of this program.
  255.  
  256. YOU SHOULD ALWAYS MAKE A BACKUP OF THE DIRECTORY YOU ARE WORKING IN
  257. BEFORE YOU BEGIN WITH GSR. 
  258.  
  259. GSR is a tool, nothing more. It can be used in a damaging way as easily as
  260. a beneficial way. I hope you find it of benefit to you. I wished for a program
  261. like this for a long time, and after giving up hope of finding it, I finally
  262. wrote it myself. I use it constantly, and wish I'd had it years ago. 
  263.  
  264. Good Luck, Good Programming, and God Bless You.
  265.  
  266. My motto:    Easier is Better!