home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / Rhapsody / unix / hack / class-dump.2.1.1.README < prev   
Encoding:
Text File  |  1997-12-12  |  3.5 KB  |  84 lines
  1. class-dump is a utility for examining the Objective-C segment of
  2. Mach-O files.  It generates the @interface and @protocol declarations
  3. for classes, categories and protocols.
  4.  
  5. Version 2 is a re-implementation of Eric P. Scott's class-dump, and
  6. works with the frameworks in Openstep 4.x.
  7.  
  8. The source compiles on Nextstep 3.3 with Foundation, Openstep, and
  9. Rhapsody.  Binary releases are available for all architectures
  10. available on each of these:
  11.  
  12.     class-dump.2.1.1.PI.bs.tar.gz     (Rhapsody)
  13.     class-dump.2.1.1.m.NIS.bs.tar.gz  (Openstep)
  14.     class-dump.2.1.1.NIHS.bs.tar.gz   (Nextstep)
  15.  
  16. Compiling
  17.  
  18.     Bison is required to compile this.  There should be no warnings.
  19.  
  20.     To compile under 3.3, first copy the Makefiles and PB.project from
  21.     the NS3.3 directory into the main source directory and then build it.
  22.  
  23. Differences between 2.1.0 and 2.1.1
  24.  
  25.     - Compiles under Rhapsody, Openstep and Foundation based Nextstep
  26.       3.3.  Tom Hageman provided the changes to get it working with
  27.       Nextstep 3.3 and compiled it quad-fat.
  28.     - Under Rhapsody, the -C option now takes egrep style regular
  29.       expressions to match categories and protocols.  It will still
  30.       work as before with text strings, but you can, for example,
  31.       specify -C 'View|Window' to match classes with both strings.
  32.  
  33. Differences between 2.0 and 2.1.0
  34.  
  35.     - The -a option has been split into -a, which just shows instance
  36.       variable offsets, and -A, which shows method addresses.
  37.       (Suggested by Charles Lloyd.)
  38.     - Protocol definitions are all printed at the beginning of the
  39.       output for each file.  Duplicate protocol definitions are no
  40.       longer shown.
  41.     - New option, -S, to sort the output.  Protocols are sorted by
  42.       name.  Classes and categories are sorted by name.  Class and
  43.       instance methods are each sorted by name.  (Suggested by
  44.       Charles Lloyd.)
  45.     - When the -S option is not used, the method definitions are
  46.       printed out reversed from the order they are found in the
  47.       Mach-O file.  This should reflect the order they are declared
  48.       in the original source file.
  49.     - The effect of the -C option has changed.  It now matches
  50.       category and protocol names instead of just class names.
  51.       (Carl Lindberg pointed out that categories should also be matched.)
  52.     - Corrected output when the target file doesn't have an
  53.       Objective-C segment.
  54.     - An 'id *' type  should now be printed correctly.
  55.     - Fixed printing of pointers to arrays.
  56.     - Fixed printing of multi-dimensional arrays.
  57.     - Made #ifdefs of LC_PREBOUND_DYLIB and LC_LOAD_DYLIB independant
  58.       for compiling under 3.3 (Suggested by Carl Lindberg.)
  59.     - This now uses the Foundation framework, so it may not work with
  60.       Nextstep 3.x.
  61.     - flex is no longer required.
  62.     - The version number of class-dump is now included in the output.
  63.  
  64. Visible differences between version 2 and version 1
  65.  
  66.     - class-dump works with framework based files (the whole point of this
  67.       exercise!)
  68.     - The class declaration shows the adopted protocols.
  69.     - Protocol definitions are shown before (rather than after) the class
  70.       declaration.
  71.     - New option, -r, to recursively expand frameworks and fixed VM
  72.       shared libraries.
  73.     - A comment is generated to show the file where the classes are
  74.       defined.  This is helpful when using the -r option.
  75.     - New option, -s, to use "char *" instead of "STR".
  76.  
  77. Known problems
  78.  
  79.     None.
  80.  
  81. Comments and suggestions are welcomed.
  82.  
  83. Steve Nygard <nygard@telusplanet.net>
  84.