home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1994 June / NEBULA_SE.ISO / SourceCode / MiscKit / Projects / MiscFindPanel / SearchBench / README < prev    next >
Encoding:
Text File  |  1993-10-22  |  3.0 KB  |  67 lines
  1. This is a simple application that illustrates using the MiscFindPanel
  2. in a project.  It alleges to do a timing comparison between the
  3. Text class's (in NEXTSTEP 3.x) built-in findText:... method and
  4. the Misc_TBMK/regexpr routines included with this package.
  5.  
  6. This is version 1.1 (22 October 1993).
  7. This product requires NeXTSTEP 3.x or higher.
  8.  
  9.  
  10. Note that the Text class is at a slight disadvantage when it comes
  11. to regular expression searching--it doesn't do them.  Also, the
  12. timing is not meant to be very precise, though some steps are
  13. taken in the Timer class to eliminate obvious potential skews to
  14. the results.
  15.  
  16. The real important stuff in this example (with regards to incorporating
  17. the MiscFindPanel.bundle into a project) are in the SearchBench.nib
  18. file (connections from the Find menu to the first responder), the
  19. addition of the links to the project directory and files to the project
  20. file, and the modification to Makefile.postamble to only partially
  21. strip the executable upon installation.
  22.  
  23. Some people believe that bundles are a good idea for development, but
  24. all code should be statically linked for a shipping product.  I'm not
  25. convinced of this, at least in this case (this find panel).  The
  26. benefits that statically linking the bundle code and whatnot into an
  27. application are merely that (1) you can strip the main executable
  28. completely, and (2) when the user first asks for find panel functionality,
  29. it would happen somewhat faster.  But the second point is a one-time
  30. cost, and the first point is really of concern only to people running
  31. NEXTSTEP on a 200MB disk or less, or running the developer package in
  32. under 400MB.  It is a matter of only 100K or so.  But, I leave the
  33. decision to you, the developer.
  34.  
  35. The executable was compiled under 3.1.  It may run under 3.0, I
  36. don't know.
  37.  
  38. The code is but sparsely commented, but there isn't much example-
  39. specific code anyway.
  40.  
  41.  
  42. Written and maintained by Christopher J. Kane (kane@gac.edu).
  43. Please feel free to contact the author with any questions,
  44. comments, bug reports, or suggestions about this package.
  45.  
  46. Copyright (c) 1993 Christopher J. Kane.  All rights reserved.
  47.  
  48. This software is subject to the terms of the MiscKit license
  49. agreement.  Refer to the license document included with the
  50. MiscKit distribution for these terms.
  51.  
  52. ---------------------------------------------------------------------------
  53. README                   - This file
  54. SBApp.h                  \ Subclass of Application to take
  55. SBApp.m                  /   care of a couple things
  56. Timer.h                  \ Implements SearchableText protocol to wrap
  57. Timer.m                  /   the MiscSearchText methods and time them
  58. Info.nib                 - Info panel
  59. SearchBench.nib          - Main nib file with main window
  60. Makefile                 \
  61. Makefile.postamble        \
  62. PB.gdbinit                 | Project-related files
  63. PB.project                 |
  64. SearchBench.iconheader    /
  65. SearchBench_main.m       /
  66. ---------------------------------------------------------------------------
  67.