#
# 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 <interface> 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".