home *** CD-ROM | disk | FTP | other *** search
/ Software Du Jour / SoftwareDuJour.iso / BUSINESS / DBASE / DBREP.ARC / REP.DOC next >
Text File  |  1985-12-17  |  7KB  |  171 lines
  1.                                   R E P
  2.                 (Global Search and Replacement in DBASE III)
  3.  
  4.  
  5. COPY NOTICE:
  6.  
  7.          This software may be freely copied with the only restriction that all rights to commercially market the software remain solely with the programmer.
  8.  
  9.                                                (c) Michael Mackay 1985
  10.                                                    22 East 31st St. (4B)
  11.                                                    New York, N.Y. 10016
  12.  
  13. DISCLAIMER:
  14.  
  15.           There are no warranties, express or implied, in the fitness of this software and in no event shall the programmer be held responsible for any indirect, special, incidental or consequential damages or losses resulting from its use.
  16.  
  17.  
  18. PROGRAM SPECIFICATIONS:
  19.  
  20.          REP consists of two command files written in standard DBASEIII command language (REP.PRG and REPSUB.PRG) and an ASCII text file containing instructions (REP.DOC).  No experience in DBASE programming is needed to run this program.  However, an understanding of word processing, particularly global search and replace features, is assumed.  Users should first experiment with this program on a test database.  
  21.  
  22.  
  23. PURPOSE:
  24.  
  25.          REP is a specialized word processing program for conveniently editing records.  It allows for easy insertion, deletion or replacement of text within a specific field without the cumbersome process of manually positioning the cursor and entering one or more control keys.  REP is particularly useful for editing long fields and performing the same change in more than one record (global search and replace).  The program also provides considerable flexibility:  changes may be confirmed record-by-record (verified) or entered automatically (global).  For verified changes, select records may be skipped, edited manually, or replaced with an alternate character string.
  26.  
  27.  
  28. INSTRUCTIONS:
  29.  
  30. 1.  To initiate REP enter the following command from the DBASE dot prompt:
  31.  
  32.                    . do rep
  33.  
  34. (Unless otherwise indicated, all characters may be entered in upper or lower case.  In these instructions system prompts appear in uppercase and operator responses appear in lower case.)
  35.  
  36.          NOTE:  The program proceeds from the current record.
  37.  
  38. 2.  Enter the name of the field you wish to search, e.g.:
  39.  
  40.                    FIELD TO SEARCH:  desc
  41.  
  42. 3.  Enter the character string you wish to search for and replace, e.g.:
  43.  
  44.                    REPLACE WHAT:  sesame
  45.  
  46.          NOTE:  This part of the program distinguishes between upper and lower
  47.                 case letters.
  48.  
  49. 4.  Enter the text, if any, you wish to replace the old character string with:
  50.  
  51.                    REPLACE WITH:  poppy
  52.  
  53.         NOTE:  This part of the program distinguishes between upper and lower
  54.                case letters.
  55.  
  56. 5.  The program displays the search condition, e.g.:
  57.  
  58. FIELD:      DESC
  59. REPLACE:    sesame  WITH  poppy
  60. ----------------------------------------------------------------------------
  61. (Searching ... )
  62.  
  63. If no records are found to contain "sesame" in the DESC field, the following message appears:
  64.  
  65.                    NUMBER OF REPLACEMENTS:         0
  66.  
  67. If a record is found that matches the search string, the record number, the name of the field and the field contents are displayed.  At the bottom of the screen the followup options are presented, e.g.:
  68.  
  69. FIELD:      DESC
  70. REPLACE:    sesame  WITH  poppy
  71. ----------------------------------------------------------------------------
  72. RECORD:     3
  73. DESC:       Two all beef patties, special sauce, lettuce, cheese, pickle,
  74.         onion on a sesame seed bun.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83. ---------------------------------------------------------------------------
  84.  
  85. Replace - R     Continue - C    Edit - E         Quit - <RETURN>
  86. Replace all (unverified) - X    Replace w/ other text - O
  87.  
  88. ENTER YOUR SELECTION HERE:  
  89.  
  90. 6.  Select one of the six followup options by entering the letter corresponding to your choice:
  91.  
  92.         R - Replace.  Replaces the specified search string with the specified
  93.             replacement string.
  94.  
  95.         C - Continue.  The change is not made and the program continues to
  96.             search for the next occurrence.
  97.  
  98.         E - Edit.  The cursor moves into the field for full screen editing.
  99.             Press <Pg Dn>, <RETURN> or <Ctrl> W after making changes.
  100.  
  101.         X - Replace all (unverified).  All subsequent records containing the
  102.             search string are automatically changed. 
  103.  
  104.         O - Replace with other text.  The program prompts for a new
  105.             replacement string for the current record, e.g.: 
  106.  
  107.                     REPLACE WITH:  caraway
  108.  
  109.         <RETURN> - Quit.  REP is terminated and you return to the dot prompt.
  110.  
  111. 7.  Unless you select 'X' for unverified replacement, the program displays the new field contents and provides you with an option to cancel.  E.g.:
  112.  
  113. FIELD:      DESC
  114. REPLACE:    sesame  WITH  poppy
  115. ----------------------------------------------------------------------------
  116. RECORD:     3
  117. DESC:       Two all beef patties, special sauce, lettuce, cheese, pickle,
  118.             onion on a poppy seed bun.
  119.  
  120.  
  121.                    ITEM REPLACED.
  122.  
  123.                    FIND NEXT ONE?  (Y/N)  
  124.  
  125. Type 'Y' to continue the search.  Enter <RETURN> to return to the dot prompt.     If you type 'N', the following prompt appears:
  126.  
  127.                    ANOTHER CHANGE, SAME FIELD?  (Y/N)
  128.  
  129. Type 'Y' to enter a new search string.  Searching will proceed from the top of the database.  Enter <RETURN> to return to the dot prompt.  Type 'N' to return to the original prompt:
  130.  
  131.                    ENTER FIELD TO SEARCH:
  132.  
  133. At the end of each search the total number of replacements is displayed.
  134.  
  135.  
  136. SPECIAL CASES:
  137.  
  138. 1.  If the field being replaced contains more than one occurrance of the search string all occurances will be flagged for replacement.  There are two exceptions where only the first occurance will be replaced:  (1) if the record is the first record in the database, and (2) if the replacement string includes the search string, e.g. REPLACE  cheese  WITH  Swiss cheese.
  139.  
  140. 2.  If the replacement will cause the field contents to exceed the field length the following warning message will appear:
  141.  
  142.                    WARNING - LAST x CHARACTERS WILL BE LOST.
  143.  
  144. "X" refers to the number of characters that will be trimmed by the replacement.  This feature is only active during verified replacements.
  145.  
  146. 3.  If a semi-colon is to be included in the search string, make sure it is NOT the last character.  A semi-colon at the end of the search string acts as a pause in the program's execution.
  147.  
  148.  
  149. TO EXIT THE PROGRAM:
  150.  
  151.         Press <RETURN> at any of the following prompts:
  152.  
  153.                 FIELD TO REPLACE:
  154.                 ENTER YOUR SELECTION HERE:
  155.                 FIND NEXT ONE?  (Y/N)
  156.                 ANOTHER CHANGE, SAME FIELD?  (Y/N)
  157.  
  158.         or press the <Esc> key at any time during the program's execution.
  159.         Enter "Y" after the DBASE message:   Terminate Command File?  (Y/N)
  160.  
  161.  
  162. LIMITATIONS:
  163.  
  164. 1.  REP works only with character-type fields.
  165.  
  166. 2.  The search string may not contain both single and double quotes.  An error message appears.
  167.  
  168. 3.  The program will not be able to make a replacement in a field that contains both single and double quotes.  You will be prompted to edit the field manually.
  169.  
  170.  
  171.