# # SUMMARY: What's new in this version of the OO-Browser? # # AUTHOR: Bob Weiner # # ORIG-DATE: 15-Oct-90 # LAST-MOD: 3-Jan-02 at 18:18:42 by Bob Weiner # # Copyright (C) 2000-2001 Bob Weiner # Copyright (C) 1990-1999 BeOpen.com # See the file BR-COPY for license information. # # This file is part of the OO-Browser. --------------------------------------------------------------------------- VERSION 4.08 * V4.07 was released as a sourceforge.net project. Updated the mailing list and support e-mail addresses to point to the sourceforge lists. See "www.sf.net/projects/oo-browser" for more details. * Added support for the GNU General Public License Version 2. See "BR-COPY". * Clarified installation instructions in "BR-README". * If help-mode is available, can now use {q} to exit from OO-Browser information display buffers shown in the viewer window. * Many bug fixes for initial version of the Python support code and elsewhere, notably a regexp overflow bug when scanning C++ code. See "ChangeLog" for details. * Python OO-Browser ** See the `Python Specifics' section of the OO-Browser user manual, "(oo-browser)Python Specifics", for how to use the following new features. ** Added global variable browsing support. ** Added module and package browsing support. ** Added support for Python OO-Browser Environments which include C or C++ code. ** Support for source file lookup within directories listed in the PYTHONPATH environment variable. ** Added support for all docstring types, not just method docstrings. ** Improved class scanning. ** Integration with Python's pydoc self-documentation module when the separate pydoc.el interface package is available. Download pydoc.el from: "www.deepware.com/pub/python". ** Support for browsing Java-type interfaces within Python. The add-on Python module, bwcto_interface, lets you define interfaces within Python which the OO-Browser will then browse. Download bwcto_interface from "www.deepware.com/pub/python". ---------------------------------------------------------------------------------- VERSION 4.07 * Bug fix release. * Integrated OO-Browser Options with InfoDock's Options menu. * Fix startup time library dependency failure. * Java OO-Browser: Fixed handling of classes with no `extends' or `implements' clauses. When edit a class, point is now left at the beginning of the class def line as expected, not after initial modifiers such as `public'. * Windows Graphical OO-Browser: Fixed bug in source code which failed to deselect a node before deleting it. (The binary is not fixed yet so if you want this fix, you will have to build the binary yourself for now.) --------------------------------------------------------------------------- VERSION 4.06 * Bug fix release. * Separated binary distributions from the rest of the OO-Browser distribution so that parties who use it on multiple platforms don't have to download the Lisp and documentation multiple times. --------------------------------------------------------------------------- VERSION 4.05 * Open Sourced the commercial-quality multi-language OO-Browser. * Added C construct support for Python and Eiffel. * Added support for building the Texinfo version of the OO-Browser Manual. * Improved function handling. * Added support for HP-UX distributions. --------------------------------------------------------------------------- VERSION 4.04 * Improved selection and error reporting within *Implementors* buffers that list potential implementors of a method. These are displayed when multiple implementations of a method name are detected after an Action Key click on the method name within a code buffer. * The Use-Vi-as-Editor option worked only if an xterm was used as the shell from which vi is run. Now other shells work. * Improved handling when a dedicated frame is used to display the OO-Browser and the frame is deleted. It now is recreated. --------------------------------------------------------------------------- VERSION 4.03 * Added support for the pop-tag-mark command {M-*} available in some editors to move back to prior code locations displayed from clicking the Action Key on an identifier or other cross-reference. * Fixed Action Key support for selecting an overloaded method within an *Implementors* buffer. Such a buffer is generated by the OO-Browser in response to an Action Key click on an overloaded method call. * C++ OO-Browser ** Eliminated rare false matches within conditional statements that look like function calls and eliminated processing of ::function references within function bodies. ** Improved matching between declaration and definition of a function where the two have different whitespace or contain * characters within their return types. ** Added .inc and .hpp as C++ header file suffix types since some libraries use these. ** Eliminated substring problem where searching for implementors of `func' would include entries such as `function'. * Windows OO-Browser ** Added potential support for background building of Environments. * Many subtle bug fixes. --------------------------------------------------------------------------- VERSION 4.02 * C++ OO-Browser ** Improved handling of nested template class and parent declarations. ** Improved handling of complex method declarations. ** Support for the `typename' keyword. --------------------------------------------------------------------------- VERSION 4.01 * C++ OO-Browser ** Improved recognition of C++ template and array constructs. ** Modified listing prefix for structs and enums from "- " to "= " for now. * Eiffel OO-Browser ** Multiple attribute declarations such as: `a,b,c: TYPE' may now be viewed individually within the browser. Multiple routines definitions were already handled by the browser. ** Improved recognition of Eiffel inherit clauses, external features and Windows-based Eiffel files. ** Made the class `ANY' a parent of any class without an inheritance clause (lacking any explicit parents). ** The OO-Browser now browses ISE's publicly released BASE data structures library and the SmallEiffel class libraries as well. * Python OO-Browser ** Corrected comment recognition and improved expression matches. ** Added Action Key clicking on import modules or the specific classes, methods, functions or variables that they reference. A click on any such name locates the associated definition and displays it. * Java OO-Browser ** Improved recognition of Java attributes. * Eliminated invalid association of an existing Env name with a newly created Env file. * With XEmacs under the X Window System, the Backspace key now works just like the Delete key in listing buffers, scrolling the viewer window back a windowful. * Bug fixes. --------------------------------------------------------------------------- VERSION 4.00 * An OO-Browser menubar entry has been added to the global menubar under XEmacs and GNU Emacs to simplify invocation of the OO-Browser for new users. (InfoDock has long had this feature.) * The Action Key part of whose function is to display classes and features when clicked upon in listing buffers is now bound to the middle mouse button on 3-button systems and the left mouse button on typically 2-button systems. (InfoDock has long had this feature.) * Environments are now named, with a full suite of menu and keyboard commands for adding, removing, renaming, listing and changing Environment associations to names. Environment names eliminate the need to remember where each Environment is stored within a file system. You are prompted to add a name to an Environment when trying to load an Environment to which you have not yet assigned a name. Names are user-specific so that each user can have names that are most memorable and easiest to use according to their own tastes. Names may however be copied for sharing and site-wide commonality; BeOpen.com support programs can help you with such configuration. * Within OO-Browser listing windows, the title bar above the frame displays both the name and full pathname of the Environment being browsed for easy reference. It also shows the version of the OO-Browser in use. * Redesigned all feature handling code to speed feature queries. A test Environment of 586 C++ classes on a Pentium II 350 Mhz Linux system required only 1.5 seconds to list all of its features (9859 entries including classes). The time went from 15 seconds in V3.07 to 1.5 seconds for a 10-fold speedup. A user-visible side-effect of this speedup under MS operating systems only (due to their lack of the -d option to their builtin sort function), is that features are alphabetized by category, e.g. regular methods in one group, special methods in other groups, followed by attributes. * Restructured internals for improved efficiency and reliability. * When scanning trees of code directories, symbolic link subdirectories are now ignored since these sometimes cause circularities that can produce an infinite recursion. If any code lives within another tree, the Environment can specify inclusion of its root directory. If a root directory given as an Environment search path is a symbolic link, it is scanned, only subdirectory symbolic links are ignored. * Features in a graphical OO-Browser display may now be edited or viewed read-only rather than just viewed. * PC files ending with carriage-return and linefeed characters are now handled without any need for conversion. * The {@} command which shows a class within its textual inheritance graph no longer hides all other entries within the current listing. This brings it into conformance with other OO-Browser commands. * C++ OO-Browser ** Pure virtual functions are now shown properly within feature listings. ** C constructs of enumerations, structures, typedefs, and unions declared within classes are now recognized. Their type definitions are listed under associated default classes, e.g. [enumeration]. Any variable names associated with these declarations are shown as attributes under the class in which they are declared. ** Fixed to handle unsigned attribute declarations. * Eiffel OO-Browser ** Added support for multiple routine definitions with a single definition signature. ** Made {i} show class info binding work automatically without the need to call another setup command. * Lisp/CLOS OO-Browser ** Improved implementors listings involving default classes. ** All feature listings now have categorizing prefixes as in other languages. Constants and variables are now preceded by "= "; for now, other features all are preceded by "- ". * Eliminated Rebuild-Lib-Part and Rebuild-Sys-Part from the OO-Browser/Environment menu since these are seldom used. * Bug fixes. --------------------------------------------------------------------------- VERSION 3.07 * When an Environment is reloaded within the OO-Browser (using {C-c C-l}), the browser display is completely refreshed to its beginning state as if a different Environment had been loaded. This eliminates any issue of having stale data in a listing window after an Environment load. * Improved the output of `br-where' {w} to include the class name of any feature being displayed. * When prompted to load or to create an Environment, completion now occurs in the current directory rather than the directory of the last used Environment. Thus, by moving to the directory in which you want your Environment to be saved and then using {C-c C-o} or {M-x oo-browser RET}, you will be able to just hit return when promted for an Environment name. * Switching from one language Environment to another now automatically updates the Environment feature file in use. * Eiffel OO-Browser: ** Updated feature handling to latest OO-Browser standards. This fixed problems with a number of Eiffel operations. ** Classes are now shown in upper case as they are in Eiffel code. ** Speeded up feature scanning when building Environments. ** Eiffel Environments built with earlier versions of the OO-Browser are now obsolete. You will be prompted to rebuild them whenever out-of-date Environments are loaded. * Bug fixes. --------------------------------------------------------------------------- VERSION 3.06 * The emacs-related editor in use and other current environment information is now included within the output of {M-e} (br-env-stats) when within a browser listing window. * Bug fixes. * Improved feature listings to leave same named features in the same order as they occur within the source file. * C++ OO-Browser ** Static data members (attributes for which one copy is shared by all instances of a class) are now prefixed with an "& " prefix to distinguish them from replicated attributes which are prefixed with "= ". ** Improved C++ declaration recognition. ** Improved case-sensitivity when locating features. ** Improved constructor recognition. ** Method argument lists may contain either :: scoped operators or () operator related parentheses. The browser will properly recognize such methods if they contain one or the other but not both embedded parentheses and scoping operators. This limitation is related to poor design in the C++ language that reuses the : and parentheses characters within method declarations for multiple purposes. ** Class declarations conditionalized with #ifdef preprocessor constructs are now handled better; only one version of such a class declaration will appear within an Environment. * Java OO-Browser ** Constructs from C files found within Java Environment source directories are now listed within Java Environmens as they are within C++ and Objective-C Environments. --------------------------------------------------------------------------- VERSION 3.05 * Up to 6-fold improvement in the speed of building C++ and other language environments under InfoDock and XEmacs; 14-fold speedup under GNU Emacs. * C++ OO-Browser: Improved attribute matching including array support. * Support for viewing and editing elements/features with external viewers/editors. (Earlier versions support external viewing of classes only.) * New menu item, Options/Use-Vi-as-Editor to toggle the setting of whether the internal editor or Vi is used when edit commands are issued in the OO-Browser listing windows. Viewing commands remain unaffected. * Bug fixes. --------------------------------------------------------------------------- VERSION 3.04 * Windows OO-Browser: ** Added a version of the graphical OO-Browser for use under MS Windows-based OSes and window systems. It works in the same way as the X OO-Browser. The textual OO-Browser automatically selects the appropriate graphical browser to use under each OS. ** Added Windows support under GNU Emacs major release 20. * C functions are now found using a variant of the etags program called `ootags' to prevent any naming conflicts with other versions of etags on a system. --------------------------------------------------------------------------- VERSION 3.03 * The OO-Browser program directory is now called oo-browser. * C++ OO-Browser: Fixed support for global operator+ and operator- functions. Be sure to not leave whitespace between the `operator' and its type symbol, e.g. =, when writing global operators or the browser may not browse it properly. Whitespace is handled in scoped :: operators. * Many bug fixes, notably a fix for the problem where the OO-Browser reports that a class is not defined in the Environment even though its definition was found. (This occurred only when a class was referenced in one part of the Environment, e.g. System, and then defined in the other part, e.g. Library.) --------------------------------------------------------------------------- VERSION 3.01 and 3.02 * C++ OO-Browser: Reduced large Environment build times by approximately 36% through a number of optimizations. * Environments now store the start and end times of the last build of the Environment. When in the OO-Browser, {M-e} (br-env-stats) will show these times. It will also show an improved summary of the number of classes and interfaces in the Environment. * Many bug fixes. * If you have a problem building an Environment in the background under XEmacs or InfoDock, you can now use {C-u M-x br-env-rebuild RET} to build an Environment and to generate a stack backtrace when errors occur. --------------------------------------------------------------------------- VERSION 3.00 * New key bindings and commands: ========================================================== OO-Browser Listing Menu Item Window Key Binding ========================================================== r Feature/Routines = Feature/Attributes < View-Window/To-Buffer-Beginning > View-Window/To-Buffer-End , View-Window/Scroll-Backward-One-Line . View-Window/Scroll-Forward-One-Line M-0 P Options/List-Protocols-with-Classes Standalone browser features (those useful in code buffers outside of the browser user interface) are now bound to keys by default (which differ from the previously recommended bindings to prevent conflicts with other packages). ========================================================== Source Code Command Buffer Key Binding ========================================================== C-c M-f br-find Prompt with completion for a class or element name from the current Environment and display its definition for editing. C-c M-j (C++ only) br-feature-edit-declaration Prompt with completion for a CLASS::FEATURE argument and then edit the associated declaration. If point is on a feature definition signature in a code buffer (prior to any of its arguments), the default is to edit that feature's declaration. An error is signaled if the declaration is not found. C-c M-w br-where Display in the viewer window and return the full path of the defining file for a browser listing entry. Optional prefix arg PROMPT means prompt for the entry name; automatically prompts if called interactively outside of a listing window (in standalone mode), e.g. within a source code buffer when the browser user interface is not displayed. If called in standalone mode with a prefix argument, the command inserts the defining path at point rather than displaying it elsewhere. M-TAB br-complete-symbol Complete an OO-Browser type or element or an Emacs Lisp symbol preceding point. The symbol is compared against current Environment entries (or Emacs symbol table entries) and any needed characters are inserted. * Redesigned menus for clarity and ease of use. Added Graphical Menu to centralize graphical browser commands. Also added documentation entries that display help for each menu and each menu concept, such as `Feature'. Added an item on the OO-Browser menu that e-mails pre-paid support issues directly to BeOpen.com. * Made Ancestor menu entries behave exactly as the {a} and {C-u a} keys do, rather than inverting ancestor listings, since the difference could be confusing. * Simplified the (br-add-class-file) command bound to {C-c ^}. It now tries to determine by itself whether to add the class to the Library or System part of the Environment. * Eliminated the load of an Environment after it is built in batch mode since the editor session is terminated immediately after the build. * Fixed so that when switch Environment languages, the new Environment is always properly loaded. * Simplified installation and batch usage of the OO-Browser. * C++ OO-Browser: ** Attributes (data members) declared within class definitions are now included in Environments. Environments will take a bit longer to build but will be more complete. ** Friend classes are now included in Environments (previously only individual friend features were included). ** Because of the above changes, Environments built with versions of the OO-Browser prior to 3.00 are now obsolete. The browser will prompt you to rebuild such Environments when they are loaded. ** Action Key presses at the start of feature declarations and definitions jump back and forth between matching definitions and declarations. ** Action Key presses on types found within method signature argument lists try to display the definitions of the types. ** Improved default feature name computed for various commands when point is within the pre-argument part of a declaration or definition of a feature. ** Allow single-line C or C++-style comments between method arguments when searching for matching definitions and declarations. ** Numerous special case fixes for optimum performance. ** Fixed parsing of global `operator' features which ootags mishandles. * Java OO-Browser: ** Require types for all feature declarations and definitions. ** Action Key presses on types found within method signature argument lists try to display the definitions of the types. ** Eliminated false matches to statements that look like method signatures, e.g. if (expr) { body }. ** Eliminated failure of feature and ancestor queries made when point was in the middle of an entry name. ** Clarified the message display when a feature definition is found. ** Made br-find work for Java features. * Graphical OO-Browser ** Fixed so that the selected tree node is highlighted in red on 16-bit-plane and higher displays. (Previously, no highlight was seen.) ** ANSIfied the C source code and added initial multi-platform configuration support. ** Eliminated jumping between windows within the textual browser to display entries selected within the graphical browser. ** Coming soon: A native Windows port of the graphical browser. --------------------------------------------------------------------------- VERSION 2.13.01 * Java OO-Browser: Fixed regexp scanning bug that could cause a hang when scanning Java class files that contain multiple blank lines at the end of the file. * New menu item Option/List-Protocols-with-Classes which is on by default includes protocols (interfaces) in the listings of all classes or top-level classes under Java and Objective-C. If you want to turn this off in your editor initialization file, add the expression: (setq br-protocols-with-classes-flag nil) * Listing buffers have been renamed from `Inher-Lvl-' to `OO-Browse-' and now contain both the key binding that generated the listing and the listing number (sequential from 1). So if the third listing command that you use is the ancestors command bound to {a}, its output would be shown in a buffer named `OO-Browse-a3'. * Each command that displays its output in a new listing window uses the next window to the right (and then wraps back to the first window on the left). Some commands used to use the prior left window and so could obscur recently generated information. * New key bindings in listing buffers: {A} = list all classes (this used to be {C-u t} which still works) {T} = list top-level classes (this used to be {t} which still works) --------------------------------------------------------------------------- VERSION 2.13.02 * C++ OO-Browser: Allow for #define replacement keyword between the `class' literal and the class name, a technique used in some class libraries. --------------------------------------------------------------------------- VERSION 2.13 * Eliminated issues with running the OO-Browser under Microsoft OSes which lack typical UNIX executables like sort and make used by the OO-Browser. * Eliminated `file has changed' messages when browse an Env after building it in the background. * C++ OO-Browser ** Improved handling of variable declarations with template args. ** Improved recognition of "type var1, var2, var3;" declarations. ** Made feature matches work under GNU Emacs 20 (in prior versions could signal an error). --------------------------------------------------------------------------- VERSION 2.12.05 * C++ OO-Browser bug fixes and addition of class name display when a feature definition is found since the class name may not be on the screen otherwise. --------------------------------------------------------------------------- VERSION 2.12.04 * All Environment handling commands now prompt with a full pathname of the most recent Environment as a default and beep if an attempt to enter a directory name is made. * Modified installation instructions to require loading of initial browser files at startup, rather than autoloading. This avoids any undefined Action/Assist Key autoloads. * Added support for Action Key selection of identifiers within the body of features defined within the class declaration itself. In earlier releases, a click anywhere on the first line of an in-class method definition would just move the first line of the definition to the top of the window. Now that happens only if you click before the opening brace. This applies to C++, Java and Objective-C files. * Background builds should now reload and redisplay the Environment properly after finishing. If the Environment built is the same one currently being browsed, the Environment is reloaded and the browser reinitialized automatically when the build finishes. * C++ OO-Browser ** Fixed recognition of C++ feature definitions. ** When Action Key press on a C++ member reference, if no possible definitions are found within the Environment, it will try to display a matching declaration instead. ** Declaration recognition is much improved. ** {j} and {J} commands now work when used on entries from [default classes], i.e. C constructs. They also will now find a declaration for which no definition exists within the Environment. ** References that start with the pseudo-variable `this->' now work properly when the Action Key is pressed on them. ** Made commands that display declarations and definitions of features show the class of the feature in the minibuffer message since it may not be visible on screen. ** Significantly improved default prompting based on a feature name or feature reference at point, whether in code or within a listing buffer. Also corrected several bugs. --------------------------------------------------------------------------- VERSION 2.12.03 * Simplified listing display of implementor signatures when the browser produces more than one feature entry as possible matches for a feature reference. * Action and Assist Mouse Keys work under GNU Emacs 20. * Action and Assist Key direct selection of entities has been greatly expanded. See the Hyperbole Manual for a superset of the things that can be clicked upon for action. * C++ OO-Browser ** You should rebuild any C++ Environments built with earlier versions of the browser as this may improve commands which work with feature entries. ** New {j} key binding to jump to (view) the declaration (header) of the entry at point. {C-u j} prompts with completion for the name of the feature declaration to view. ** New {J} key binding to edit the declaration of the entry at point. {C-u J} prompts with completion for the name of the feature declaration to edit. ** Feature name completion when used in source buffers prompts with much more intelligent defaults than in prior versions. ** Action Key clicks on var.attribute or var->attribute feature references display the attribute definition for editing if var is declared within the current bufffer and the attribute is lexically defined within the class given by the type of var. Inherited attributes will be supported in the future. Action Key clicks on method calls also work better. --------------------------------------------------------------------------- VERSION 2.12.02 * Added support independent of a full Hyperbole for Action Key clicks within C, C++, Java, Lisp and Objective-C buffers as documented in the OO-Browser user manual. * When the browser is invoked and a background build is initiated, the buffer showing the status of the build is displayed in the viewer window. * When a background Environment finishes, the built Environment is loaded if it is the current Environment or the user asks to browse it. * Improved Environment loading if user aborts during some of the Environment build prompts. * Selection of completions with the Action Key is much more reliable. * In-buffer and minibuffer completion lists of classes, features and elements now work correctly. --------------------------------------------------------------------------- VERSION 2.12.01 * Clarified prompts sent to the user when building an Environment to reduce the need for reading the manual before getting started. * Now works with GNU Emacs 20. * Background building under GNU Emacs now works. * Now works without a full distribution of Hyperbole installed. * Reloading the same Environment after a {C-u q} now works without error. --------------------------------------------------------------------------- VERSION 2.12 * OO-Browser Multi-language Changes ** New class and protocol-oriented menu items "Protocols" and "All-Protocols" plus "Implementors" and "All-Implementors". ** Action Key clicks within the whitespace preceding classes or interface/protocols displays their ancestors; an Assist Key click in the same context displays descendants. The same click on a feature line displays the implementors of the feature. ** Action or Assist Key clicks on default class names (those delimited by square brackets, []) lists the instances of the default class, e.g. the instances of [interface] are all interface names within the Environment. ** Added text to help the user identify and correct the problem when an OO-Browser Environment is moved from one location to another but the pathnames it refers to are not updated. ** The {I} (br-implementors) command has been extended to work on interfaces (Java) and protocols (Objective-C), each of which are shown in the browser delimited by <>. The implementors of an interface/protocol are those classes which lexically define the methods specified by the interfaces. Classes that inherit such method definitions are not list as implementors. Use {d} (br-descendants) on an interface/protocol entry to see all classes that conform to the entry. Implementors are now shown in the next listing window rather than the prior one since they are more like descendant relations than ancestral ones. ** {P} (br-protocols) on a class entry now shows all interfaces/protocols to which a class conforms (including those it inherits), not just those referenced within the class declaration. Also changed this command when on an interface/protocol entry to display the interfaces to which the entry conforms, just as it does for regular classes. Use {v} or {e} to display the interface declaration itself for viewing or editing. The OO-Browser command/help menu bound to {h} now documents the {P} key. ** Method implementors no longer include entries from interfaces/protocols since these are abstract entries, not implementations. ** The Action Key, when pressed on individual class or interface/protocol names referenced for inheritance purposes within the initial line of a class declaration, jumps to their associated declarations. ** Modified the way the browser displays definitions/declarations. Point is now left on the first line of the definition, not on preceding comments, although the preceding comments are also displayed. Comments that do not begin a line are ignored, so that lines such as: @end /* comment */ are not considered preceding comments. * C++ OO-Browser ** Navigating from method declarations to their definitions now works when classes are declared within the same files as the methods rather than in header files. * Java OO-Browser ** Added full support for browsing interfaces just like classes; additionally, implementors of interfaces may be listed. Use the {f} (br-features) command on the top-level default class, [interface], to see all interfaces defined within the Environment. Interface entries are shown delimited by <>. ** Interface method declarations are now properly categorized as abstract methods within OO-Browser listings. ** Due to changes in the handling of interfaces, Java OO-Browser Environments built prior to V2.12 are obsolete. The browser now prompts the user to rebuild such Environments whenever they are loaded. * Objective-C OO-Browser ** Fixed so {I} (br-implementors) works when used on feature entries or class category entries. ** Added support for method signatures which end with ,... This syntax is used within GNUstep libraries. ** Due to changes in the handling of interfaces, Objective-C OO-Browser Environments built prior to V2.12 are obsolete. The browser now prompts the user to rebuild such Environments whenever they are loaded. --------------------------------------------------------------------------- VERSION 2.11.03 * OO-Browser Multi-language Changes ** When using OO-Browser Environments outside of the browser user interface to click on identifiers and jump to their definitions, the location of display of new files and buffers is controlled by Hyperbole's `hpath:display-buffer' function which allows user-level control of where display occurs. ** The browser now skips CVS subdirectories by default when scanning source code. See the documentation for `br-skip-dir-regexps' for more details. * C++ OO-Browser ** Support for .CXX and .HXX suffixes from case-insensitive platforms. ** Eliminated false #define macro listings when a simple constant contains parentheses. ** Method and function call browsing is now supported by pressing the Action Key on a call after an Environment has been loaded. The OO-Browser deals with much of the complexity of C++'s calling syntax so you need not (though it doesn't yet account for method overloading). In cases where it cannot determine a unique definition (e.g. where dynamic binding is involved), it pops up a list of possible definitions (method signatures). An Action Key click on any of these (or on the class names separating these signature lines) will display the definition within the source code. ** An Action Key press on pretty much any class name, including those preceeding the :: scoping operator in a method call, jumps to the class declaration. * Java OO-Browser ** All interfaces and classes mentioned within `implements' and `extends' clauses are now properly recorded. Interfaces give Java a limited form of multiple inheritance which is reflected by the OO-Browser. There is as yet no visual distinction within listing buffers between interface and class names. ** Classes which are referenced but not defined in the Environment are now assumed to inherit directly from Object so that it remains the sole top-level class. --------------------------------------------------------------------------- VERSION 2.11.02 * Added support for new C++ `restrict' keyword. * Added hmouse-tag.el file to support jumping from C-based headers to their definitions when a full Hyperbole distribution is not available. * Added support for rebuilding C constructs when just the System or Library part of an Environment is rebuilt. You must first rebuild in its entirety any Environment built with an earlier version of the OO-Browser; then rebuilding either part of it will work properly. --------------------------------------------------------------------------- VERSION 2.11.01 * Case-sensitive feature name lookup in C++, C, Java, Python, and Objective-C. * Added support for running the OO-Browser in a dedicated frame under InfoDock. --------------------------------------------------------------------------- VERSION 2.11 * OO-Browser Multi-language Changes ** {M-x oo-browser RET} now prompts to return to the previously browsed Environment. ** Errors in redrawing trees in the X OO-Browser when collapse a node are gone (double buffering during redrawing had to be disabled). ** Fixed a number of bugs. See the "ChangeLog" file. ** Edited whole OO-Browser Manual. ** Long comments preceding an element definition no longer scroll the element outside of the window bounds. ** The {br-where} command now displays its output in the viewer window so that it is never truncated and the results can be more easily reused. * C++ and Objective-C OO-Browser ** C functions are included in Environments only if `br-c-tags-flag' is t, which is the default. ** C constructs whose name comes at the end of a multi-line { list }, such as an enum, now are displayed in their entirety. (The old behavior displayed just the final line of the construct. ** Action Key presses on global C identifier references within code jumps to their definitions. ** Global variables and individual enumeration labels are now listed in default classes [variable] and [enum_label] respectively. * Eiffel OO-Browser ** Added details to the OO-Browser Manual concerning the br-entry-info command bound to {i} under Eiffel. --------------------------------------------------------------------------- VERSION 2.10 * OO-Browser Multi-language Changes ** Added Show-Inherited-Features toggle button to the OO-Browser Options menu. This determines whether or not inherited features are shown when listing class features. (The default is `on'.) ** Adding a single class to an Environment with the br-add-class command now properly adds its features too. Similarly, the br-delete command deletes associated features. ** X OO-Browser bug on some platforms that blackened the whole window after drawing the tree may be eliminated on some platforms, but not all. ** br-edit-feature is now more flexible, permitting separate specification of class and feature name arguments. ** Fixed br-find-file to never display a file in a browser listing window. ** Eliminated unnecessary execution of mode-specific hooks when scanning class files. For example, invocation of syntax highlighting could slow down scanning dramatically. ** Added BeOpen.com contact info to version/credit screen that appears on startup or when using the {C-c #} command in the browser to make it easy for people to get commercial support or custom develpment for the OO-Browser. * C++ OO-Browser ** Added support for multi-line virtual method declarations. * Java OO-Browser ** Attributes are now included as features of a class (you must rebuild any existing Environment to have them included). They are prefaced with "= " when shown in a browser listing buffer. ** Array return values from methods are now handled properly by the OO-Browser scanner. ** Feature name completion now works properly, whenever the browser prompts for a feature name. ** Added support for .jav files for 3-character suffix impaired users. ** Cleaned up a number of areas of the code that were improperly carried over from the C++ OO-Browser. ** Removed support for threadsafe keyword since it has been deleted from the language specification. * Objective-C OO-Browser ** objc-feature-matches can now take a regular expression and return all matching features. * Python OO-Browser ** Included support for the Python object-oriented scripting language. --------------------------------------------------------------------------- VERSION 2.9.11 * Added man/br-design.texi to document the design rationale of the OO-Browser. * Java: The OO-Browser now works on code with the new Java exception syntax: public Connection(String host, int port) throws UnknownHostException, InputOutputException {} * Fixed mouse key initialization bug. * C: Fixed bug in displaying structure or enum definitions. * Emacs 19: Fixed bug that caused OO-Browser menubar menu not to appear. * BR-README: Rewrote Installation / Configuration section. --------------------------------------------------------------------------- VERSION 2.9.10 * {M-x br-report-bug RET} bound to {C-c C-b} in OO-Browser listing buffers can be used to send mail to the OO-Browser discussion list. * A number of significant bug fixes, including errors triggered when scanning source directories and encountering an unreadable file. See "ChangeLog". * .icc and .I C++ inline definition file suffixes are now supported. * Any time an Environment is built interactively, you are queried whether or not to build it in the background. * If you try to load an Environment which has not yet been built and you decide not to build it, then the load is aborted rather than prompting you for another Environment to load. --------------------------------------------------------------------------- VERSION 2.9.9 * Standard OO-Browser invocation command renamed to `oo-browser' for clarity. `oobr' still exists for backward compatibility. Invocation is now much simpler and cleaner. You are always prompted for the Environment to browse, but if you hit {RET} immediately or if you give a prefix argument to the command, then you jump right into browsing the previous Environment. This eliminates the problem new users had in not knowing how to switch Environments. See "(oo-browser.info)Loading Environments". * {q} to quit from the OO-Browser now always puts the browser buffers at the bottom of the buffer list, as it should. * Subdirectories whose names are a single character long now are scanned properly. * br-skip-dir-regexps and br-file-dir-regexp are now documented in the manual, see "(oo-browser.info)Customization". --------------------------------------------------------------------------- VERSION 2.9.8 * Improved tree-x/Makefile support for building under UNIX System V. * Fixed bugs in Java Environment building. * Added Java Specifics section to the OO-Browser manual. --------------------------------------------------------------------------- VERSIONS 2.9.6 and 2.9.7 * Added support for browsing Java code. * A number of bug fixes. --------------------------------------------------------------------------- VERSIONS 2.9.4 and 2.9.5 * Eiffel: Added some new Eiffel V3 keywords. * Added information on the new oo-browser mailing list in the "BR-README" file. Also added menu items to subscribe to / unsubscribe from the list and to send mail to it. * CLOS: Changed language name to Lisp, since the browser is useful on non-CLOS Lisp too. --------------------------------------------------------------------------- VERSION 2.9.3 * Environment files now contain the version of the OO-Browser which was used to build them. If the Environment file format is obsolete, the OO-Browser will automatically prompt you to rebuild it whenever you load it. * {C-c C-s} now properly saves Environment features, when the Environment is renamed. * The browser user interface will now display within a frame even if you have set the unsplittable frame property. * Eiffel: Fixed bug that prevented display of a feature from its listing entry when using {f}. --------------------------------------------------------------------------- VERSION 2.9.2 * Added pulldown and popup menu support for Emacs 19. * `make install' now installs OO-Browser documentation in an Emacs tree. --------------------------------------------------------------------------- VERSION 2.9.1 * C++/C/Objective-C: NOTE: You must rebuild any Objective-C Environments that you have built with earlier versions of the browser. If you want the new C default classes described below to appear in C++ Environments, you must rebuild them, too. The OO-Browser now supports browsing the following C constructs within C++ and Objective-C Environments via default classes: DEFAULT CLASS C CONSTRUCT -------------------------------------- [constant] #define constant [enumeration] enum {} [function] non-member function() [macro] #define macro() [structure] struct {} [type] typedef {} [union] union {} You may now define a C++ Environment which contains only C code. The above default classes are the only ones that will appear in such Environments. * C++: Added recognition of keywords, `mutable' and `explicit', newly added to standard C++. * Removed key binding of br-toggle-keep-viewed since this is little used and reused its key, {V}, for br-view-friend, which views the definition of a C++ friend declaration. This was mistakenly formerly bound to {M-v} which conflicted with a basic scrolling command. * C++: Recognition of new array operators, `operator new [] ()' and 'operator delete [] ()'. * The X OO-Browser can now be built on systems without the usleep system call (see oo-browser/tree-x/Makefile). * {M-e}, br-env-stats, now shows the names of any classes which are defined multiple times within the Environment, to help you eliminate duplicates. It also shows a list of undefined classes, those which are referenced, e.g. as parents of another class, but not defined within the Environment. --------------------------------------------------------------------------- VERSION 2.9 * C++: See the C++ Specifics section of the OO-Browser manual for user documentation on all of these changes. * C++: friend declarations now appear in class feature listings, prefixed by `% '. {V} views the definition of a friend. * C++: pure virtual functions now appear in listings as `> func' instead of `func = 0'. Object creation and deletion functions appear as `+ func' instead of `- func'. * C++: Overloading of operator[] and operator() is now supported. * C++: Greatly speeded up feature listings by caching feature names. * C++: Expanded variety of complex declarations/definitions that the browser recognizes. * Eiffel: Added full feature browsing as in other languages along with Eiffel V3 support. --------------------------------------------------------------------------- VERSION 2.8.6 * Added KEYWORDS: header to all *.el files, so the Emacs finder program, {C-h p}, can now include them in its indices for lookup. * C++: Added support for browsing pure virtual function interfaces declared within classes. Given a pure virtual function named, f, it appears as, f = 0, in a browser listing buffer to distinguish it from a member definition. * C++: Improved scanning of a broader range of C++ definitions. * {C-u F} now works properly. It shows the signatures/tags of all features in the current listing buffer. * CLOS: Added proper support for &keywords in argument lists. * CLOS: All methods which do not contain any specialized parameters (those of a specific type) are considered members of the root CLOS class `t'. --------------------------------------------------------------------------- VERSION 2.8.5 * Documented InfoDock/XEmacs menus in the manual. * Improved Makefile support for adding custom load-path entries. * Emacs 19 versions now run site-start.el when batch compiling files. --------------------------------------------------------------------------- VERSION 2.8.4 * Added autoload comments so that autoloaded OO-Browser commands are automatically picked up under V19. * The default display of class features/elements, bound to {f}, now includes all inherited features. Use {M-0 f} to turn off display of inherited features. * Under XEmacs when mouse support is available, there is an OO-Browser pulldown menu and the same menu as a popup, bound to the right mouse button when in a browser listing buffer. * Instantiation of templates is handled well now, especially when a parent class is a template instantiation. * Action Key press on a C++ class feature declaration now properly jumps to the definition. --------------------------------------------------------------------------- VERSIONS 2.8.2 and 2.8.3 * New version of the X OO-Browser with more reliable display updates after a node is collapsed and a color X resource file. * Support for C++ template class and method browsing. * Under C++, non-class functions are now found and added to the default [function] class for easy browsing. This includes both C and C++ functions. * Br-unique, {u}, and br-order, {o}, now work on all entry types, not just classes. * New command, br-match-entries, bound to {M}. Permits filtering of the set of entries in a listing buffer. Under Emacs 19, you can still browse entries after filtering them. Emacs 18 doesn't permit this since each entry name is not necessarily unique. * Many bug fixes and many fewer invalid method tag matches under C++. * Much faster compilation of the OO-Browser Emacs Lisp source code since all files are compiled with one invocation of Emacs, rather than one per file. * Environment builds may now be done in the background. (You are prompted for whether to build in the background, each time you build an Environment. When the build finishes, you are asked if you would like to browse the built Environment.) * Eiffel 3 inheritance clause support. --------------------------------------------------------------------------- VERSION 2.8.1 * Much faster C++ feature lookups. You *must* rebuild any C++ Environments built with earlier versions of the OO-Browser before trying to browse features within the Environment. Load such an Environment and use {C-c C-e} to rebuild it. * XEmacs 19.12 mouse support. --------------------------------------------------------------------------- VERSION 2.8 * Command and Key Binding Improvements ** Action Key press on an OO-Browser environment file named OOBR or OOBR-FTR, automatically determines the language of the Environment and loads it for browsing. ** Common Lisp and Emacs Lisp element browsing support added. Standard language element types are added as default classes to Environment, so one can browse functions, variables, methods and more. See "(oo-browser.info)CLOS Specifics" for details. ** The feature listing command, br-routines, previously bound to {r}, has been renamed br-features and bound to {f}. {f} used to run br-find; use {C-u e} (br-edit-entry) for that command instead. This makes the bindings of {f} and {F}, which lists feature signatures, more uniform. {r} still works for backwards compatibility in this release. ** {f} if applied to a single class for which there are no feature definitions within the Environment, displays the associated class definition so that you may browse its feature declarations. This improves browsing in Environments where you have only interface specifications, e.g. *.h files, but no source code. ** Fixed {I}, br-implementors command. Also, now an Action Key press on an implementor class shows the implemented element. ** {C} lists class categories. Presently only supported under Objective-C. {v} or {e} views or edits the class category definition. {I} shows the classes which implement a category. The [category] default class displays all Environment categories as its features. {v} or {e} then displays the associated category definition. ** {P} lists class protocols. Presently only supported under Objective-C. {v} or {e} views or edits the class definition which directly conforms to the protocol. {I} shows the classes which implement a protocol. The [protocol] default class displays all Environment protocols as its features. {v} or {e} then displays the associated protocol definition. * Graphical Browser Improvements ** Motif version of the X OO-Browser interface redone using the Athena toolkit, so that only free X libraries are required. Thanks to Torgeir Veimo for this conversion work. * Many bug fixes. ** The browser will no longer scan SCCS revision subdirectories by default. ** Better support for the wide variety of C++ coding styles and file naming conventions. * User Manual Improvements ** Reorganized and renamed sections for clarity. ** New sections: *** "(oo-browser.info)Browsing Categories" *** "(oo-browser.info)Browsing Elements" *** "(oo-browser.info)Browsing Implementors" *** "(oo-browser.info)Browsing Protocols" ** Expanded glossary in user manual. * Installation Improvements ** Improved Makefile to support all common Emacs versions. ** More detailed installation notes in "BR-README".