home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Utilities / Programming / PowerReplace 4.1 / Documentation / PowerReplace Readme < prev    next >
Encoding:
Text File  |  1995-12-18  |  5.2 KB  |  118 lines  |  [ttro/ttxt]

  1.  
  2.  
  3.  
  4.                          
  5.                              PowerReplace Readme
  6.                                                        December 2, 1995
  7.                                              Copyright © 1995 by Guoniu Han. All rights reserved. 
  8.  
  9. ___________________________________________________________________
  10.  
  11. Overview:
  12. In the actual computer science world there are many text file formats for different raison, and we need often convert one format to another. Usually it means simply replace some strings by the others. Of course some text editors provide this possibility with “find and replace” command. But with this command it is almost impossible for a complicated multi-replcace conversion.  
  13.  
  14. PowerReplace is a powerful text conversion utility using the Drag/Drop technology. It can replace character (include CR, LF, TAB) and string by any other string. By use of the special character * for any indeterminate string, it can replace also a string only whose two extremities are known. For example, it can delete both two types of comments in a C++ source file (/*comment*/ and //comment).
  15.  
  16. PowerReplace has an option “Copy resources”. It seems to me very important. For example I often use this option to convert TeX 8 bits file with pictures to TeX 7 bits file. In these files, pictures are stocked in the resource 'PICT'.
  17.  
  18.  
  19. QuickStart:
  20. - Frequently, you need only to do Drag/Drop.
  21. - If you want to change filter file for other replacement, select corresponding item of the menu “Filter”.
  22. - If none of the filter files is convenient for you, create your own filter file. See “FilterFile Doc” to learn how to create a new filter file.
  23. - See also the documentation “for beginners” to learn step by step from a complete example.
  24.  
  25. Help:
  26. PowerReplace supports the Balloons Help system.
  27.  
  28.  
  29. Features:
  30. - Very fast!!!
  31. - Can copy resources and keep the same type-creator.
  32. - Easy to change the filter file and remember the last filter file.
  33. - Can override old text file, or save new file with extension name.
  34. - Easy to create new filter file.
  35.  
  36.  
  37. Menu Commands:
  38. - Open & Convert...: 
  39. Opens a text file and realizes all replacements containing in the filter file chosen. Recommend to use Drag/Drop technology.
  40.  
  41. - [?] Use Balloons Help: 
  42. PowerReplace supports Balloons Help system. Use this menu item for turn Balloon Help on or off. Recommend to use the Finder menu “Show/Hide Balloons”.
  43.  
  44. - Make Filter File: 
  45. Creates filter file from text file. See also “FilterFile Doc”.
  46.  
  47. - Filter: 
  48. This menu contains some filter files. To use one of them, select it.
  49. To add a new filter item into this menu, put the associated filter file into the “Filter” folder, and restart the application.
  50.  
  51.  
  52. Requirements:
  53. The program can be run on any Macintosh computer. You need system 7 or later. I've tested it on a Mac LCIII, IIfx, and PowerMac 6100. Report any bug or suggestion to me at guoniu@math.u-strasbg.fr. Thank you.
  54.  
  55.  
  56.  
  57. Distribution:
  58. PowerReplace is distributed as shareware. You can distribute freely the unregistred copy to your friends, over BBS or online services. You may include it in CD-ROM or other shareware collections. Of course, you must include all files that were included with this version. You may not distribute a registred copy of PowerReplace, SelfReplace Maker or any SelfReplace application made by a registred copy of SelfReplace Maker.
  59.  
  60.  
  61. Registration:
  62. As shareware, PowerReplace may be used for a trial period of 4 weeks. If you decide to continue using it you must register your copy. For only US $25, you can register PowerReplace and SelfReplace Maker. As registred user,  you will benefit following advantages:
  63.   - your question will be answered quickly by email.
  64.   - PowerReplace version will be updated freely as soon as possible by email. 
  65.   - your requirement will be added, within my capacity.
  66.   - your name will be included in the next version.
  67. Please use "Registration Form"  file to register.
  68.  
  69.  
  70. Disclaimer:
  71. PowerReplace and SelfReplace Maker are copyright © 1993-1995 by Guoniu Han, all rights reserved. Althougt I have made a great effort, I'm not sure that it is bug free.  When using this application, the user assumes all responsibility for any damages caused, directly or indirectly, by its use.
  72.  
  73.  
  74. Version history:
  75. •4.1 <1995.12.18> 
  76. - Fat version for 68k Macintosh and Power Macintosh (PPC native).
  77. - Other small changes.
  78.  
  79. •4.0 <1995.12.02> 
  80. - First shareware version.
  81. - Included SelfReplace Maker1.0.
  82. - Added “for beginners” documentation.
  83.  
  84. •3.1 <1995.11.21> 
  85. - Fixed a bug concerning MakeFilterFile Window update.
  86. - Fixed a bug concerning the length of file.
  87. - Added Balloons Help system.
  88. - Remember the filter file by its name instead of its item number of the menu “Filter”.
  89. - Search filter file only in the “Filter” folder.
  90.  
  91. •3.0 <1995.11.06> 
  92. - Small changes.
  93. - Added FAQ file.
  94. - Used movable dialog.
  95.  
  96. •2.2 <1995.10.30> 
  97. - Changed name to “PowerReplace” because the name “DropConvert” is used. 
  98.  
  99. •2.1 <1995.10.24> 
  100. - First public release as “DropConvert”. 
  101. - Added Make FilterFile menu.
  102.  
  103. •1.2 <1995.04.17> 
  104. - Used the Drag/Drop technology.
  105.  
  106. •1.0 <1993.04.12> 
  107. - A very simple version for my personal use only.
  108.  
  109.  
  110. _____________________________
  111.  
  112. Guoniu Han
  113. 30, avenue du Gal de Gaulle
  114. 67000 Strasbourg, France
  115. email: guoniu@math.u-strasbg.fr
  116. http://130.79.4.26/~guoniu/mac/
  117. _____________________________
  118.