Source

oo-browser / BR-RELEASE

   1
   2
   3
   4
   5
   6
   7
   8
   9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19
  20
  21
  22
  23
  24
  25
  26
  27
  28
  29
  30
  31
  32
  33
  34
  35
  36
  37
  38
  39
  40
  41
  42
  43
  44
  45
  46
  47
  48
  49
  50
  51
  52
  53
  54
  55
  56
  57
  58
  59
  60
  61
  62
  63
  64
  65
  66
  67
  68
  69
  70
  71
  72
  73
  74
  75
  76
  77
  78
  79
  80
  81
  82
  83
  84
  85
  86
  87
  88
  89
  90
  91
  92
  93
  94
  95
  96
  97
  98
  99
 100
 101
 102
 103
 104
 105
 106
 107
 108
 109
 110
 111
 112
 113
 114
 115
 116
 117
 118
 119
 120
 121
 122
 123
 124
 125
 126
 127
 128
 129
 130
 131
 132
 133
 134
 135
 136
 137
 138
 139
 140
 141
 142
 143
 144
 145
 146
 147
 148
 149
 150
 151
 152
 153
 154
 155
 156
 157
 158
 159
 160
 161
 162
 163
 164
 165
 166
 167
 168
 169
 170
 171
 172
 173
 174
 175
 176
 177
 178
 179
 180
 181
 182
 183
 184
 185
 186
 187
 188
 189
 190
 191
 192
 193
 194
 195
 196
 197
 198
 199
 200
 201
 202
 203
 204
 205
 206
 207
 208
 209
 210
 211
 212
 213
 214
 215
 216
 217
 218
 219
 220
 221
 222
 223
 224
 225
 226
 227
 228
 229
 230
 231
 232
 233
 234
 235
 236
 237
 238
 239
 240
 241
 242
 243
 244
 245
 246
 247
 248
 249
 250
 251
 252
 253
 254
 255
 256
 257
 258
 259
 260
 261
 262
 263
 264
 265
 266
 267
 268
 269
 270
 271
 272
 273
 274
 275
 276
 277
 278
 279
 280
 281
 282
 283
 284
 285
 286
 287
 288
 289
 290
 291
 292
 293
 294
 295
 296
 297
 298
 299
 300
 301
 302
 303
 304
 305
 306
 307
 308
 309
 310
 311
 312
 313
 314
 315
 316
 317
 318
 319
 320
 321
 322
 323
 324
 325
 326
 327
 328
 329
 330
 331
 332
 333
 334
 335
 336
 337
 338
 339
 340
 341
 342
 343
 344
 345
 346
 347
 348
 349
 350
 351
 352
 353
 354
 355
 356
 357
 358
 359
 360
 361
 362
 363
 364
 365
 366
 367
 368
 369
 370
 371
 372
 373
 374
 375
 376
 377
 378
 379
 380
 381
 382
 383
 384
 385
 386
 387
 388
 389
 390
 391
 392
 393
 394
 395
 396
 397
 398
 399
 400
 401
 402
 403
 404
 405
 406
 407
 408
 409
 410
 411
 412
 413
 414
 415
 416
 417
 418
 419
 420
 421
 422
 423
 424
 425
 426
 427
 428
 429
 430
 431
 432
 433
 434
 435
 436
 437
 438
 439
 440
 441
 442
 443
 444
 445
 446
 447
 448
 449
 450
 451
 452
 453
 454
 455
 456
 457
 458
 459
 460
 461
 462
 463
 464
 465
 466
 467
 468
 469
 470
 471
 472
 473
 474
 475
 476
 477
 478
 479
 480
 481
 482
 483
 484
 485
 486
 487
 488
 489
 490
 491
 492
 493
 494
 495
 496
 497
 498
 499
 500
 501
 502
 503
 504
 505
 506
 507
 508
 509
 510
 511
 512
 513
 514
 515
 516
 517
 518
 519
 520
 521
 522
 523
 524
 525
 526
 527
 528
 529
 530
 531
 532
 533
 534
 535
 536
 537
 538
 539
 540
 541
 542
 543
 544
 545
 546
 547
 548
 549
 550
 551
 552
 553
 554
 555
 556
 557
 558
 559
 560
 561
 562
 563
 564
 565
 566
 567
 568
 569
 570
 571
 572
 573
 574
 575
 576
 577
 578
 579
 580
 581
 582
 583
 584
 585
 586
 587
 588
 589
 590
 591
 592
 593
 594
 595
 596
 597
 598
 599
 600
 601
 602
 603
 604
 605
 606
 607
 608
 609
 610
 611
 612
 613
 614
 615
 616
 617
 618
 619
 620
 621
 622
 623
 624
 625
 626
 627
 628
 629
 630
 631
 632
 633
 634
 635
 636
 637
 638
 639
 640
 641
 642
 643
 644
 645
 646
 647
 648
 649
 650
 651
 652
 653
 654
 655
 656
 657
 658
 659
 660
 661
 662
 663
 664
 665
 666
 667
 668
 669
 670
 671
 672
 673
 674
 675
 676
 677
 678
 679
 680
 681
 682
 683
 684
 685
 686
 687
 688
 689
 690
 691
 692
 693
 694
 695
 696
 697
 698
 699
 700
 701
 702
 703
 704
 705
 706
 707
 708
 709
 710
 711
 712
 713
 714
 715
 716
 717
 718
 719
 720
 721
 722
 723
 724
 725
 726
 727
 728
 729
 730
 731
 732
 733
 734
 735
 736
 737
 738
 739
 740
 741
 742
 743
 744
 745
 746
 747
 748
 749
 750
 751
 752
 753
 754
 755
 756
 757
 758
 759
 760
 761
 762
 763
 764
 765
 766
 767
 768
 769
 770
 771
 772
 773
 774
 775
 776
 777
 778
 779
 780
 781
 782
 783
 784
 785
 786
 787
 788
 789
 790
 791
 792
 793
 794
 795
 796
 797
 798
 799
 800
 801
 802
 803
 804
 805
 806
 807
 808
 809
 810
 811
 812
 813
 814
 815
 816
 817
 818
 819
 820
 821
 822
 823
 824
 825
 826
 827
 828
 829
 830
 831
 832
 833
 834
 835
 836
 837
 838
 839
 840
 841
 842
 843
 844
 845
 846
 847
 848
 849
 850
 851
 852
 853
 854
 855
 856
 857
 858
 859
 860
 861
 862
 863
 864
 865
 866
 867
 868
 869
 870
 871
 872
 873
 874
 875
 876
 877
 878
 879
 880
 881
 882
 883
 884
 885
 886
 887
 888
 889
 890
 891
 892
 893
 894
 895
 896
 897
 898
 899
 900
 901
 902
 903
 904
 905
 906
 907
 908
 909
 910
 911
 912
 913
 914
 915
 916
 917
 918
 919
 920
 921
 922
 923
 924
 925
 926
 927
 928
 929
 930
 931
 932
 933
 934
 935
 936
 937
 938
 939
 940
 941
 942
 943
 944
 945
 946
 947
 948
 949
 950
 951
 952
 953
 954
 955
 956
 957
 958
 959
 960
 961
 962
 963
 964
 965
 966
 967
 968
 969
 970
 971
 972
 973
 974
 975
 976
 977
 978
 979
 980
 981
 982
 983
 984
 985
 986
 987
 988
 989
 990
 991
 992
 993
 994
 995
 996
 997
 998
 999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
#
# 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".