home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 December / macformat-019.iso / Shareware City / Developers / FindIt Folder / ReadThisTextFile < prev   
Encoding:
Text File  |  1993-02-22  |  7.3 KB  |  168 lines  |  [TEXT/R*ch]
  1. FindIt
  2.  
  3. Introduction
  4.  
  5. One of the things that drives me nuts is trying to find out what header file
  6. Apple put a function prototype into. Some are obvious some are not. So I wrote
  7. a program to search through a folder, (or some folders, (or some folders inside
  8. other folders)), full of text files for a text string.
  9.  
  10. If you find this program useful send me a post card or an E-mail message. If
  11. you think this is a stupid program send me a postcard or an E-mail message and
  12. tell me why.
  13.  
  14. Other free programs
  15.  
  16. ChemTools: Calculates molecular weight given a molecular formula, displays
  17. some useful constants, displays valence electrons for atoms.  Runs under
  18. System 6 and System 7.
  19.  
  20. Table: A periodic table click on an element and get some useful information
  21. about it.  Runs under System 6 and System 7.
  22.  
  23. ChangeMaker: Drop a file or a set of files on Change maker and you can change
  24. each file’s type and creator individually. Runs under System 7. But works with
  25. System 6.
  26.  
  27. Instructions
  28.  
  29. Just drag a folder onto the FindIt icon. It is OK if there are other types of
  30. files in the folder FindIt will skip those.
  31.  
  32. A small dialog box will appear. Enter the text you want to find. The text must
  33. be exact. Regular expressions are not implemented. (Yet.) Using the check boxes
  34. select either a case insensitive search, and/or recursive folder search. (A
  35. recursive folder search, searches folders inside folders, inside folders…) Hit
  36. the return key or click on the OK button. Also select whether or not you would
  37. like the full path name of the file or just the file name displayed. FindIt
  38. remembers the check box selections during a session and between runs.
  39.  
  40. If FindIt finds the text the full path name of the file will be displayed,
  41. along with the line number the text was found on and the line as well.
  42.  
  43. FindIt uses the spinning beach ball cursor trick to let you know how things are
  44. progressing. A little spin for each file.
  45.  
  46. “done.” is printed when FindIt is done searching all the files.
  47.  
  48. Text can be cut, copied or cleared from the display. Cmd-A doesn’t select all
  49. the text, it clears it. Be careful.
  50.  
  51. To search again just drop a folder on the FindIt icon. It may be grayed out
  52. because the application is running. There is no need to quit. The new results
  53. are placed after the old results.
  54.  
  55. For ResEdit Users
  56.  
  57. There isn't much you can change using ResEdit, but you can change the “Found
  58. in:” heading for the path to the file. It's in STR# resource 128 string 1.
  59.  
  60. Limitations
  61.  
  62. The display uses TextEdit to display the found files and lines. FindIt won’t
  63. bomb if you try to stuff more than 32K character into the display but the
  64. output is truncated. I tested this by finding “;” in the apple header files.
  65.  
  66. The search uses a straight Boyer-Moore text search. I wanted a fast search.
  67. Maybe I’ll put in regular expression searching, if there is a real interest.
  68.  
  69. FindIt searches the files a line at a time. Lines should be less than 2048
  70. characters long.
  71.  
  72. FindIt loads the whole file into a buffer to search it. If FindIt can’t get
  73. a buffer large enough you will get a dialog saying “Not enough memory for x”
  74. where x is some file. Try increasing FindIt’s memory partition.
  75.  
  76. There is some overhead for each file in the list of files to search. This
  77. limits the size of the file that can be searched. The more files you search
  78. the smaller the file you can search. If you have a problem with this, increase
  79. the size the partition FindIt runs in.
  80.  
  81. If you try to search very deeply nested folders with the recursive folder
  82. search the stack will overflow. By deep I mean an entire CDROM. I can search
  83. the 67 Megs of data on my hard disk in a 256K byte partition with no problems
  84. other than having to skip files too large to fit in memory.
  85.  
  86. Tips
  87.  
  88. I use System 7.0, and I keep an alias to the “Apple includes” next to an alias
  89. of FindIt on the desktop. Any time I need to find out what file to include for
  90. a function prototype, I just drop the Apple includes alias on the FindIt alias.
  91. Since the line is printed out, this is also a good way to find the order of
  92. variables in a function prototype.
  93.  
  94. Legal Stuff
  95.  
  96. Although FindIt is free, it is not “public domain”. It is copyrighted, and
  97. the copyright will be enforced whenever appropriate. 
  98.  
  99. The source is not, and will never be, available. 
  100.  
  101. FindIt cannot be sold, either by itself or in combination with any other
  102. product, without my express written permission. The one exception to this rule
  103. is made for user groups. If you’re a user group which is publishing a CD-ROM or
  104. floppy collection, you may include FindIt and all of its included files without
  105. restriction, save that the original package is included. Contact me for
  106. up-to-date versions and information. 
  107.  
  108. FindIt may be posted on an information service which charges its users for
  109. general connection time and downloading, but it may NOT be posted to an
  110. information service which will charge for the specific right to download
  111. FindIt, without my express written permission.
  112.  
  113. FindIt may be given away as a support utility for a package which is itself
  114. to be given away. People who have need to  distribute FindIt as a support
  115. utility should contact me for up-to-date versions and information.
  116.  
  117. The following warranty is merely to cover the bases: 
  118.  
  119. Geoffrey Clements makes no warranty, express or implied, with respect to the
  120. software or documentation including (but not limited to) implied warranties of
  121. merchantability and fitness for a  particular purpose. In no event will
  122. Geoffrey Clements be liable for loss of profits or goodwill or other indirect,
  123. special, incidental, or consequential damages resulting from any defect in the
  124. software or documentation, even if advised of the possibility of such damages.
  125. Geoffrey Clements shall have no liability for any data stored with this
  126. program, including the costs of recovering such data. 
  127.  
  128. Some states do not allow the exclusion or limitation of implied warranties or
  129. liability for incidental or consequential damages, so the above limitation or
  130. exclusion may not apply  to you. This warranty gives you specific legal rights,
  131. and you may also have other rights which vary from state to state. 
  132.  
  133. FindIt is copyright ©1993 by Geoffrey P. Clements. All rights reserved.
  134.  
  135. History
  136.  
  137. 1.0.0    First Release.
  138.  
  139. 1.0.1    If you allocate memory, you should check to make sure you get it. Duh!
  140.         Fixed some screen handling stuff. Fixed a memory leak.
  141.         
  142. 1.0.2    2/2/93    Added a case insensitive search. Fixed a bug in which FindIt
  143.                 would skip the last file in a folder. Fixed a bug where
  144.                 GetNewCWindow is called even if the machine doesn't have
  145.                 color Quickdraw. Remembering where the window was works
  146.                 better.
  147.  
  148. 1.1.0    2/11/93    Added “Recursive Folder Search” option. (Search folders inside
  149.                 folders.) Always add text at the end of the display. Display
  150.                 “Findit 1.1.0” as the display window title not “Search”
  151.                 Fix the line numbering. Was off by one. Added “Display Full
  152.                 Path Name” option. Increased partition size to 256K. Remember
  153.                 what options where selected for last search. Don't bomb on older
  154.                 machines that don't have Color Quickdraw, or at least pseudo
  155.                 Color Quickdraw like the Classic II has.
  156.                 
  157. 1.1.1    2//93    This should repair a problem with some older Macs in which the
  158.                 machine would bomb because of a Color Quickdraw call on non-
  159.                 color Macs. Corrected a user interface guideline inconsistency.
  160.                 Made Cmd-B clear all, and Cmd-A select all.
  161.  
  162. Geoffrey Clements
  163.  
  164. Internet:    clementsg@gw1.hanscom.af.mil
  165.  
  166. US postal:    19 Samuel Rd.
  167.             Chelmsford, MA 01824
  168.