home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / sysext / fkey / project.sit / ReadMe < prev   
Encoding:
Text File  |  1992-09-23  |  2.7 KB  |  72 lines
  1. Project Printer FKEY 1.1
  2.  
  3. Copyright ⌐ 1992 Phil Shapiro
  4. All Rights Reserved
  5.  
  6. Description
  7.  
  8. This is an FKEY which will produce a list of the files in a THINK C project. It
  9. lists the file names, object sizes, and segmentation information. It was
  10. tested under System 7 with THINK C 5.0 and 4.0. It should work with earlier
  11. versions of THINK C under System 6 as well.
  12.  
  13. Installation and Use
  14.  
  15. Since this FKEY is only useful inside of THINK C, I would recommend using
  16. ResEdit to add the FKEY resource directly to the resource fork of THINK C.
  17. Once installed, just hit the FKEY (command-shift-5 by default) and a list of
  18. the files in the current project will be pasted into an Untitled window. It
  19. won't do anything if invoked outside of THINK C, or if no project is open.
  20.  
  21. The list of files produced contains each project entry in the order that it
  22. appears in the project. At the end of each segment, the total number of bytes
  23. in that segment are printed out. An alternate listing can be produced by
  24. depressing the Caps Lock key before invoking the FKEY; this listing contains
  25. all of the project entries sorted by name, followed by the total number of
  26. bytes in the entire project. Note that the bytes printed out only reflect bytes
  27. of CODE, not DATA or JUMP.
  28.  
  29. The project window must be the frontmost window in THINK C, and the
  30. thumb for the project window's scrollbar should be at the top. See Bugs
  31. below for more information.
  32.  
  33. Customizing
  34.  
  35. You can change the FKEY's command-shift number by changing the resource ID
  36. number for the FKEY resource. This can be done using ResEdit's "Get Resource
  37. Info" menu item.
  38.  
  39. How it works
  40.  
  41. This FKEY uses a technique similar to the one used in James Walker's Text
  42. Capture FKEY. It first resizes and invalidates the project window, and then
  43. patches the traps that THINK C uses to redraw the window's contents. By
  44. watching the data sent to these patches, all the information displayed in the
  45. project window can be collected and printed out. Since this doesn't rely on
  46. the project's internal format, it should work with any version of THINK C.
  47. However, this limits the information that can be displayed to just the names
  48. and sizes of the project entries.
  49.  
  50. Bugs/Odd Features
  51.  
  52. The FKEY will only work if the Project window is frontmost. Also, if the
  53. Project window isn't scrolled to the top, only the files below the current
  54. window position will be printed out.
  55.  
  56. Version History
  57.  
  58. 1.1 - fixed incompatibility with '040 cache on Quadras
  59.       - added per-segment totals to listing
  60.       - added Caps Lock sorting option
  61. 1.0 - initial release on 3/7/92
  62.  
  63. This hack is free. Please contact me if you find any bugs, or have any
  64. suggestions for improvements!
  65.  
  66. Phil Shapiro
  67.  
  68. Internet: phils@cs.brandeis.edu
  69. AOL: PhilShap
  70. Postal:
  71. 70 Simpson Ave.
  72. Somerville, MA 02144