home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / fr.zip / README.TXT < prev   
Text File  |  1993-09-04  |  13KB  |  326 lines
  1.                                     
  2.                     Universal Find & Replace  Utility
  3.                                Version 1.0
  4.                                    By
  5.                                Softechnics
  6.                                     
  7.                            September 12, 1993
  8.                                     
  9.                            CompuServe Address:
  10.                                72123, 501
  11.  
  12.  
  13.                                   NOTE
  14.                                   ====
  15.                                     
  16. There are two (2) files in the FR.ZIP file.  FR.EXE is the Find & Replace
  17. Utility for MS-DOS based machine.  It is called FR for short.
  18.  
  19. FR  came about by the need to make changes in more then 1 file at a time.
  20. FR is versatile and unique.  It works with any file format, any type, and
  21. any  file  size, as long as you have disk space equal to or greater  than
  22. the  working  file.  It works well especially on the vector  based  files
  23. such as; .EXE .COM .DLL .DOC(Word format) .BMP .TIF  etc.. you name it.
  24.  
  25. The  word processors on the market all have excellent Search and  Replace
  26. options  but they are limited to one file,  i.e. the one in use.  Certain
  27. of  these programs allow you to program them through Macro statements but
  28. again,  it  takes  the "TIME" to learn to do the programming.   The  word
  29. processor  programs  are designed specifically to  handle  its  own  data
  30. format.   It  will not allow you to open and write to an  unknown  format
  31. safely like FR.   FR is unique in the way it scans through the file.   It
  32. does not disturb your file format.   FR will not write to a file that has
  33. no  matching search string.   If you wish to search and replace a  unique
  34. character, you can combine the Alt+N(key code) key.  N is the code number
  35. from  1 to 255, representing the ASCII and extended characters.  See your
  36. MS-DOS  manually for more details on accessing special characters through
  37. Alt+number key.
  38.  
  39. What  FR will do is "Smooth" out your multiple change problems!   If  you
  40. are a programmer, you will appreciate saving your time.   Many people use
  41. FR  to  change the data and image files, data and font files, form files,
  42. print files, executable file, Window library files.  The nice thing about
  43. FR  is,  you don't have to regenerate your file using a compiler or  word
  44. processor.   This means, you can change any file without its source file.
  45.  
  46. For  testing  purpose, this is an excellent tool  to  patch  or  add  new
  47. control string to your file before sending it to the printer.  Font maker
  48. companies  used  our FR program to experiment with their  print  sequence
  49. file.   If you find this program useful and want to continue on using  it
  50. legally,  we  recommend  that you send in your $10  register  fee.   Site
  51. license is $4 per station, $10 minimum.   You will receive newer & faster
  52. FR  version plus document.  Please include $4 for shipping and  handling.
  53. Our address is as follow:
  54.  
  55.                                SOFTECHNICS
  56.                           1900 NE. 48th Street,
  57.                                Suite A-103
  58.                             Renton, WA 98056
  59.                                     
  60.                            TEL. (206) 227-0071
  61.                            FAX. (206) 227-4048
  62.  
  63.  
  64. _________________________________________________________________________
  65.  
  66. Softechnics now offers a free English-French translator working demo  for
  67. PC,  on  a 3.5" HD diskette.  To receive your free copy, please  send  $4
  68. shipping  &  handling to our address above. You will be delighted  seeing
  69. this artificial program running.  You can use it to learn French quickly,
  70. to  convert  software  or document files from English  to  French.   Over
  71. 12,000 French conjugation table included.  That already saves you $15  by
  72. not buying the 5000 French Verb Book.
  73.  
  74.       If  you  need more information, call or write us.  To  save  $4  on
  75. shipping  and  handling, you may want to send in your  $10  register  fee
  76. along with your request for a demo copy of our English-French translator.
  77. You pay $14 total instead of $18.
  78.  
  79. _________________________________________________________________________
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86. FR USAGE:
  87. =========
  88. From the MS-DOS prompt you can call in the files you wish either by the
  89. individual name of the file, for one file change,  or use any of the MS-
  90. DOS wild card masks to pull multiple files.  You can create a batch file
  91. to automate the search and replace if so prefer.
  92.  
  93.  
  94. FR will write all changed files in which the Search string was found and
  95. replaced, to the drive from which all files resided.  If you want FR to
  96. backup your file before changing its content, include /B at the command
  97. prompt.
  98.  
  99.  
  100.  
  101. ************************************************************
  102.  
  103. ALTHOUGH FR HAS A SWITCH TO BACK-UP YOUR ORIGINAL FILE,
  104. IT IS GOOD PRACTICE TO BACK-UP THE ORIGINAL FILE
  105. BEFORE MAKING ANY KIND OF GLOBAL CHANGE.
  106.  
  107. ************************************************************
  108.  
  109.  
  110. Below are a few examples on how to use FR:
  111.  
  112.  
  113.  
  114. TO LIST FR HELP SCREEN:
  115. _________________________________________________________________________
  116.  
  117. Typing a question mark ? at the command line will display the help screen
  118. for using the FR.  For example:
  119.  
  120. C:>FR          ?                             <Enter>
  121.  
  122.  
  123.  
  124.  
  125. TO FIND & REPLACE TEXT IN A SINGLE FILE:
  126. _________________________________________________________________________
  127.  
  128. C:>FR filename /Old string/New String        <Enter>
  129.  
  130.  
  131. FR will immediately display the percentage completed.  If the file size
  132. is too small, you will not distinguish the percentage rate being
  133. displayed.   FR is fast in searching speed.  You will appreciate using FR
  134. with large file greater than one megabyte (Files such as; .HLP or .CDR or
  135. image mixed with text file.   The finished percentage is displayed
  136. smoothly for those large files.  Another nice thing about FR is, you
  137. don't have to worry about disturbing the file format.
  138.  
  139. If you are writing to .EXE, .COM, .DLL, and other vector based files.
  140. You need to match letter for letter, another word, the length of the
  141. search string must be equal to the length of the replacement string.
  142. There is a case where you might have to put extra space to equalize the
  143. replacement string with the search string.
  144.  
  145.  
  146.  
  147.  
  148. TO FIND & REPLACE TEXT IN A SINGLE FILE WITH BACKUP OPTION:
  149. _________________________________________________________________________
  150.  
  151. C:>FR Filename /Search string/Replacement S/ /B   <Enter>
  152.  
  153.  
  154.    NOTE: This  option  will  preserve your file  format.   This
  155.           technique works well with vector based files such as:
  156.           .EXE,  .COM,   and .DLL files.  This is  because  the
  157.           lengths  of  the  search string and  the  replacement
  158.           string are equal.  This will not shift the addressing
  159.           of your file away from its normal operation.
  160.    
  161.          The   /B   tells  FR  to  rename  your  old  file   as
  162.           (WHATEVER).BAK.  Only changed file will be backed up.
  163.  
  164.  
  165.  
  166. TO FIND & REPLACE CASE SENSITIVE TEXT:
  167. _________________________________________________________________________
  168.  
  169. C:>FR filename /Search string/Replacement/   /C   <Enter>
  170.  
  171.  
  172.    NOTE: This  option  causes FR to look for an exact  spelling
  173.           of  the  Search  string(letter for letter,  case  for
  174.           case).   Once  the  string is found, the  replacement
  175.           string will be inserted.  The replacement string will
  176.           not  be  altered.  If you are changing an  item  that
  177.           needs  the proper case, enter the replacement  string
  178.           in the proper case.
  179.    
  180.  
  181.  
  182.  
  183.  
  184. TO FIND & REPLACE TEXT IN MULTIPLE FILES:
  185. _________________________________________________________________________
  186.  
  187. C:>FR *.DOC /Search string/Replacement/ <Enter>
  188.  
  189. This causes FR to look for file(s) with extension .DOC, to find and
  190. replace text.
  191.  
  192.  
  193.  
  194.  
  195. TO FIND & REPLACE TEXT IN EVERY FILES UNDER CURRENT DIRECTORY:
  196. _________________________________________________________________________
  197.  
  198. C:>FR *.* /Search string/Replacement/   <Enter>
  199.  
  200.  CAUTION:There  are  files that points to other directory.   Be
  201.           sure  to put a write-protected on those file  if  you
  202.           don't   wish   FR   to  touch  them.    Usually   the
  203.           configuration file.
  204.  
  205.  
  206.  
  207.  
  208.  
  209. TO FIND & REPLACE TEXT IN EVERY FILES UNDER DIFFERENT DIRECTORY:
  210. _________________________________________________________________________
  211.  
  212. C:>FR C:\OTHERDIR\*.* /Search string/Replacement/ <Enter>
  213.  
  214.  
  215.  
  216.  
  217.  
  218. PROGRAM SPECIFICATION:
  219. _________________________________________________________________________
  220.  
  221. FILE TYPE                Compressed or uncompressed.
  222.  
  223. FILE FORMAT              Any .exe .com .dll .txt .hlp .doc etc.
  224.  
  225. MAXIMUM NUMBER OF FILES  Infinity
  226.  
  227. MAXIMUM FILE SIZE        Infinity (must have disk space greater than
  228.                          working file)
  229.  
  230. MAXIMUM FILE LINES       Infinity
  231.  
  232. LINE LENGTH (AFTER CHANGE) Variable.
  233.  
  234. BENEFIT                  fast, automatic.  FR will not disturb your file
  235.                          format.
  236.  
  237. _________________________________________________________________________
  238.  
  239.  
  240. TYPICAL APPLICATIONS:
  241. =====================
  242. FR is the ideal tool if you are upgrading from a Floppy disk based system
  243. to a Hard disk system.  You may have numerous programs that call in files
  244. from  either  A:  or B: that you will NOW want to have on  C:\  or  newly
  245. created sub directories. The FR changes all your programs that need these
  246. changes  instantly.   There are people that save hundred  of  dollars  by
  247. using  FR  to  modify existing form files, print files, to print  exactly
  248. what they want to see on the printer.
  249.  
  250. FR  is  also an indispensable tool for programmers of compiled  languages
  251. like  C,  C++,  PASCAL, dBASE II, dBASE III, FORTRAN,  COBOL,  etc.   Any
  252. language where the source code is written in text form and then acted  on
  253. by  a  compiler  and/or  linker.  Source code like Assembly  Language  is
  254. another example.  FR works with source and executable files.
  255.  
  256. As  you change any variable declaration,  variable name, constant values,
  257. drive designations, key words, etc., you simply call in the programs  and
  258. let the FR go to work.
  259.  
  260.  
  261.  
  262.  
  263. Softechnics appreciates your comment and support, please write or send
  264. your fax to us.  Thank you for using Softechnics products.
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.    +++++++++++++++++++ ORDER FORM ++ BON DE COMMAND +++++++++++++++++
  275.                                     
  276.    NAME:_________________________________________________________:NOM
  277.    COMPANY:__________________________________________________:SOCIÉTÉ
  278.    ADDRESS:_________________________________________________:ADDRESSE
  279.    CITY/VILLE:__________________STATE/PAYS___________________________
  280.                                                   Zip/Code Postal
  281.  
  282.  
  283.      Telephone:___________________           ________________________
  284.      Téléphone:                              [Visa][Master Card] No.
  285.  
  286.                                                   _______________________
  287. Disk sizes  [ ] 5.25"   [ ] 3.5"   [ ] 3.5"                 Exp.date
  288.                                                                          
  289.             1.2mb        1.4mb      720k          _______________________
  290.                                                             Signature
  291.  
  292.  
  293.      US/Canada Shipping and handling                        = $4
  294.      (In Washington? please add 8.2% sale tax)
  295.      Frais de port pour les autre pays = $8.95
  296.  
  297.  
  298. I enclose a cheque total    _______  US-Dollars
  299. Je joins un chèque à la commande de
  300.  
  301.  
  302.  
  303.  
  304. SEND YOUR ORDER TO:
  305. BON à retourner à:            SOFTECHNICS
  306.                               1900 NE. 48th Street, Suite. A-103,
  307.                               Renton, WA 98056  U.S.A
  308.  
  309.                               FAX. (206) 227-4048.
  310.                               Tel. (206) 227-0071
  311.  
  312. We welcome your comments, suggestions, and critiques.  That will help us
  313. improve our translation products.
  314.  
  315. N'hésitez pas à nous faire part de vos critiques, suggestions, et
  316. remarques eventuelles, qui seront toujours les bienvenues.
  317.  
  318.                                     
  319.                                     
  320.                We thank you for using Softechnics product.
  321.                                     
  322.                                  Merci!
  323.                                     
  324.                               A bientôt...
  325.  
  326.