annotate lisp/oobr/BR-FEATURES @ 70:131b0175ea99 r20-0b30

Import from CVS: tag r20-0b30
author cvs
date Mon, 13 Aug 2007 09:02:59 +0200
parents 4103f0995bd7
children 4be1180a9e89
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1 #
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2 # SUMMARY: Summary of OO-Browser features
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3 #
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
4 # AUTHOR: Bob Weiner
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
5 #
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
6 # ORIG-DATE: 15-Oct-90
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
7 # LAST-MOD: 3-May-96 at 21:30:00 by Harri Pasanen
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
8 #
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
9 # Copyright (C) 1990-1995 Free Software Foundation, Inc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
10 # See the file BR-COPY for license information.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
11 #
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
12 # This file is part of the OO-Browser.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
13
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
14 OO-Browser Features
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
15 *******************
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
16
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
17 The OO-Browser is a multi-windowed, interactive object-oriented class browser
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
18 similar in use to the well-known Smalltalk browsers. It is unique in a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
19 number of respects foremost of which is that it works well with a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
20 multiplicity of object-oriented languages. It provides both textual
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
21 views within an editor and graphical views under the X window system.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
22
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
23
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
24 * Support for all popular OO Languages on UNIX
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
25 ----------------------------------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
26
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
27 ** Contains support for Eiffel, C++, Objective-C, Common Lisp and its
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
28 Object System (CLOS), Java, Python, and Smalltalk class browsing.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
29 Additionally, support for browsing large amounts of material in Info
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
30 format by node name (a popular online documentation format with cross
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
31 references and hierarchical structure) is included.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
32
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
33 ** Method browsing is supported for C++, Objective-C, Eiffel, Java,
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
34 Python and CLOS. CLOS supports browsing all elements defined with
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
35 (def* constructs. In-source feature browsing is also supported for
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
36 all of these languages. One simply selects a feature name to jump to
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
37 its corresponding source. Method name overloading in C++ and inherited
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
38 feature renaming in Eiffel are fully supported.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
39
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
40 ** C code browsing is supported for C++, Objective-C and C source code.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
41
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
42 ** Objective-C category and formal protocol browsing are supported.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
43
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
44 ** C++ parameterized template classes and methods are supported.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
45
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
46 ** Immediate switching among languages is allowed. One can switch
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
47 from Eiffel browsing to C++ browsing in an instant, if so desired.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
48 Or simply run two OO-Browsers side by side.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
49
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
50 ** Multiple inheritance support is built-in, where applicable.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
51
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
52 ** Statistics on classes and Environments may be displayed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
53
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
54 ** Language-specific class information may be shown. Presently this
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
55 feature is supported only for Eiffel and Python. For Eiffel, a
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
56 listing of class parents, attributes, routines and best guess
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
57 (highly accurate) list of routine calls may be displayed. Outputs
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
58 from the Eiffel 'short' and 'flat' commands may also be shown.
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
59 For Python this feature is used to browse documentation strings in
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
60 classes and methods.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
61
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
62
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
63 * For Serious Use
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
64 ----------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
65
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
66 ** Library (stable) and System (in development) classes may be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
67 maintained and listed separately or together. Any number of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
68 Libraries and Systems may be combined for listing in a single
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
69 Environment. There are no fixed limits on the number of classes per
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
70 Environment nor on the number of Environments that may be browsed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
71
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
72 ** All source code, over 400 kilobytes, is included and is heavily
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
73 documented.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
74
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
75
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
76 * Ease of Use
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
77 -------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
78
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
79 ** Machine-independent mouse support is included along with an extremely
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
80 intuitive point and click interface that uses just two mouse keys. The
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
81 OO-Browser is pre-configured for use with the X window system, NEXTSTEP,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
82 Sunview or Apollo's DM window system under InfoDock, Emacs V19, XEmacs,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
83 Epoch, and Emacs V18. Online mouse usage help is always one key away.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
84
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
85 ** Popup and pulldown command menus are available under InfoDock, Emacs V19
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
86 and XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
87
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
88 ** The OO-Browser help display gives short descriptions of all of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
89 the commands and key bindings available in the browser. By clicking
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
90 on any such selection, the corresponding command is executed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
91
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
92 ** One may also click on class names to see ancestors, descendants,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
93 or the class itself. Just select a class name and the OO-Browser
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
94 immediately will display or edit the class' source. Once a class
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
95 file has been loaded, one can quickly switch to it by selection
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
96 from a menu of such files.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
97
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
98 ** For a number of languages, one may also select a feature
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
99 (method) name or declaration and move directly to the definition
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
100 of the feature. The browser accounts for the complexities of member name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
101 overloading in C++ and unlimited feature renaming in Eiffel so that you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
102 need not. Just click on a declaration and watch the browser display jump
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
103 to the proper defintion.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
104
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
105 ** Jump back to a previously visited class or feature by selecting from a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
106 list of recently visited ones.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
107
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
108 ** OO-Browser commands may also be invoked from the keyboard, allowing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
109 unrestricted use via standard terminal interfaces.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
110
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
111 * Speed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
112 -------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
113
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
114 ** Building Environments is fast compared to many other tools and browser
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
115 startup once an Environment has been built is very fast. Response times
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
116 on workstations are excellent; for example, in one test case, less than
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
117 two real seconds were required to display a set of complex inheritance
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
118 graphs involving over 400 classes.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
119
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
120
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
121 * Flexibility
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
122 -------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
123
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
124 ** X and NEXTSTEP hierarchy display browsers are included. They provide
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
125 views of class inheritance structure and lexically included elements,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
126 which allows for quick random access to entire Environments. A click on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
127 a class or element name immediately jumps to it in the editor, providing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
128 rapid, visual browsing. One can pop up several graphical browsers to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
129 gain several views of classes in the same or in multiple environments.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
130 All graphical browsers can communicate with a single textual browser, so
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
131 one can quickly display and edit classes from different environments
70
131b0175ea99 Import from CVS: tag r20-0b30
cvs
parents: 24
diff changeset
132 (even different languages).
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
133
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
134 ** The OO-Browser uses class source code only, hence no compiler is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
135 necessary for proper browser operation. This allows one to explore
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
136 class libraries without the need for additional tools.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
137
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
138 ** Class inheritance networks may be displayed. Either a single
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
139 inheritance level (parents or children) or the entire inheritance
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
140 network (ancestors or descendants) for a set of classes may be shown.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
141
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
142 ** Class files may be added, replaced or deleted one at a time or as a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
143 group by specifying a root directory below which all class files are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
144 found, including those in subdirectories.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
145
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
146 ** A menu of class files can be displayed for random access to specific
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
147 code modules.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
148
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
149 ** On startup, the OO-Browser lists all currently known classes within a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
150 particular Environment. Any desired classes may be found by searching
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
151 or by matching a regular expression or string to the set of class names.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
152 This may be done repeatedly to achieve an "and"-type relational query
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
153 effect.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
154
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
155 ** The number of listing windows is limited only by the screen width and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
156 the width setting used for listing windows.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
157
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
158 ** The OO-Browser is adaptable to any class-based object-oriented language.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
159
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
160
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
161 * Editor Integration
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
162 --------------------
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
163
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
164 ** The OO-Browser works with the powerful, freely distributable, GNU
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
165 Emacs editor; it works on any UNIX system display supported by Emacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
166 It is also possible to use alternative editors to view or to edit source
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
167 code displayed by the browser.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
168
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
169 ** All OO-Browser outputs are text which may be edited as desired or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
170 saved to files.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
171
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
172 ** OO-Browser functions may be used standalone within the editor
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
173 without using the multi-windowed browser interface. One useful
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
174 example is to point to a class name such as a parent class in the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
175 text of another class and have the parent's source appear in an
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
176 editable fashion.