home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / ss.zip / ss.doc next >
Text File  |  1996-11-05  |  4KB  |  83 lines
  1. SuperSearch Version 1.0 - Search and Replace text inside textfiles.
  2. -------------------------------------------------------------------
  3. 1994-10-14. Author: E.S. Dunckley, RAU
  4. Recompiled using the beta Speed os2 compiler.
  5.  
  6. BACKGROUND
  7. ----------
  8. This is a utility written in Pascal to search and replace for strings of text
  9. inside text files. The reason I've written this program is to move programs from
  10. one drive to another and then run this utility to correct drive-letter errors in
  11. all the config- and batch files. YOU can use it for whatever reason you like.
  12. You MIGHT like to use this to correct frequent typing errors in text files.
  13. USE WITH UTMOST CARE: This program does NOT ask any "Are you sure" questions!
  14.  
  15. SYNTAX
  16. ------
  17. (Thy 11th commandment: Thou should make backups! Especially before playing!)
  18.  
  19. SS.EXE filespec searchstring [replacestring] [/c]
  20.   
  21.   filespec             - any valid filespec eg. *.ini, *.bat, *.txt.
  22.   searchstring         - A valid text string without spaces.
  23.   replacestring        - (optional.) A valid replace string without spaces.
  24.   /c                   - (optional.) Do a case sensitive search.
  25.   /v                   - (optional.) gives out a bit more info.
  26.  
  27.  
  28. FEATURES
  29. --------
  30. a) Small and easy and powerfull - yeah right! The dos exe was 6kb!
  31. b) Prints out changes made to standard output
  32. c) Easy to use
  33. d) A real timesaver if you move Windows from one drive to another!
  34. e) Small on diskspace
  35. f) Sourcecode can be easily transported to any Operating system.
  36. g) 
  37.  
  38. BUGS, IRRITATIONS and WARNINGS
  39. ------------------------------
  40. a) Does NOT handle binary files - will corrupt a binary file if used on one!
  41. b) Does NOT handle filepermissions/attributes. Make sure all files in filespec
  42.    are in fact Writable.
  43. c) Does very little errorchecking.
  44. d) Leaves a $$SS.tmp file after completion. Not serious but IRRITATING.
  45. e) Very little commandline parameters - IRRITATING
  46.  
  47. HINTS&TIPS
  48. ----------
  49. Try something like SS *.ini C:\WINDOWS | MORE to have info a page at a time, or
  50. SS *.BAT \DOS > test.txt to pipe the resulting information to a file or even
  51. SS AUTOEXEC.* superpck to us SS as a unixlike GREP function!
  52.  
  53. POSSIBILITIES FOR THE FUTURE
  54. ----------------------------
  55. The first person sending me a single dollar, rand, deutchmark, yen will motivate
  56. me to do some of the following:
  57.  
  58. 0) Get someone who actually knows anything about programming to make it better.
  59. a) Get SS to do subdirectories.
  60. b) Have SS take is't input from a filelist eg SS @filelist search replace /c
  61. c) Let SS do binary files as well as text files. (bit dangerous.)
  62. d) SS feeding it's input from a pipe eg DIR | SS dos
  63. e) SS to backup files before fiddling with them
  64. f) Let SS query you which lines to replace 
  65. g) Have SS handling multiple filespecs eg SS *.ini *.grp *.bat c:\win c:\windows
  66. h) Have PLENTY of usefull parameters like /r for rename, /h for hidden  etc...
  67. i) Have SS to handle complex strings like SS *.ini "<CR><LF>" "<CR>"
  68. j) Maybe a builtin more-command?
  69. k) Maybe turn SS into a full pre-emptive multitasking 64Bit Operating System?
  70. l) Since I am a KEEN OS/2er, have SS run as a PM application?
  71.  
  72. CONTACTING THE AUTHOR and DISCLAIMER
  73. ------------------------------------
  74. I can be contacted at eddie@eng.rau.ac.za for suggestions. I am NOT responsible 
  75. for the feeble actions of my program. YOU are the one messing up your files
  76. using my program, not me! You want WHAT? To REGISTER!!??? So that I can be
  77. blamed?? Send me $1 and a postcard as a token of appreciation if I saved you
  78. some time with this utility or if you use it more than once in a lifetime.
  79.  
  80. Eddie Dunckley, Flora Villas no 41, Hull Street, Florida, South Africa, 1709
  81. Telno: (+27 countrycode?) 011 472-2703 (home) (a.h. (GMT+2!!) 011 489-2634(w)
  82.  
  83.