1
README for the Emacs Code Browser (ECB) version 2.21
7
This package contains a code browser for several programming-languages for
8
(X)Emacs. For instructions on how to use the browser read the online-help
9
either with the shipped info-manual (see "Usage" below) or direct from the
10
ECB-Homepage at http://ecb.sourceforge.net.
12
The latest version can be found at: http://ecb.sourceforge.net
18
ECB requires the following packages:
20
- Semantic, author version between 1.4 and 1.4.9
21
(http://cedet.sourceforge.net/semantic.shtml)
23
- Eieio, author version between 0.17 and 0.17.9
24
(http://cedet.sourceforge.net/eieio.shtml).
26
- speedbar, author version 0.14beta1 or higher
27
(http://cedet.sourceforge.net/speedbar.shtml)
28
IMPORTANT: The speedbar-version shipped with GNU Emacs <= 21.3 does not
29
satisfy the requirements - download and install a newer one!
31
- Optional: If Java code is edited the ECB works best when the JDEE package
32
(http://sunsite.auc.dk/jde) is installed.
34
If you use XEmacs you must have installed the package c-support (contains
35
hideshow.el). If you want to read the online-help of ECB in HTML-format you
36
must have the library browse-url (part of the mail-lib XEmacs package)
37
installed; this package is also needed for submitting problem-reports to the
41
Using the beta of cedet 1.0 (contains semantic 2.0)
42
---------------------------------------------------
44
From beginning with version 2.01 ECB supports the next generation of the
45
cedet-tools. But before the cedet 1.0 suite becomes stable this means that ECB
46
runs correctly with loaded cedet 1.0 but the ECB-upgrading festure does not
47
support autom. upgrading to latest available cedet versions. This will be
48
first available after first stable release of the new cedet-library 1.0.
50
So, if the cedet 1.0 suite is loaded then the min- and max-version of
51
semantic, eieio and speedbar (mentioned in the Requirements-section above)
58
*IMPORTANT*: The following steps 1. to 8. describe installation tasks if you
59
got the archive in the format available at the ECB website. If you use XEmacs
60
and got ECB as regular XEmacs-package (e.g. downloaded and installed by the
61
package-manager of XEmacs) then there is nothing to do for you, just start ECB
62
with `ecb-activate' or read the online-help with `ecb-show-help'.
65
1. Unpack the ECB archive (probably you have already done this :-)
67
2. Install the required semantic-, eieio- and speedbar-version.
69
*Note 1*: If the new cedet 1.0 suite should be used then just install and
70
load cedet 1.0 like described in the cedet-installation-instructions and go
73
*Note 2*: ECB maybe requires a newer version of these libraries than shipped
74
with (X)Emacs. You have to install exactly a version ECB requires and also
75
to make sure that the correct version is loaded into (X)Emacs!
77
But ECB performs two automatic checks:
79
- At load-time: It checks if the packages semantic, eieio and speedbar are
80
at least installed so ECB can be loaded. If not it offers to download
83
- At start-time: It checks if the correct versions of semantic, eieio and
84
speedbar are installed and gives you proper feedback.
86
So if you are not sure if you have installed the required packages at all
87
or if you have installed the correct versions of these packages then do
88
not worry about this, just go on with the following installation steps: If
89
ECB is missing something it will give you proper feedback and support not
90
later than at load-time or start-time!
92
3. Add the new ECB-directory to your `load-path' variable.
94
You *MUST* add the ECB-install-directory to the `load-path' either by
95
changing the `load-path' variable directly in your `.emacs' or
96
`site-lisp/site-start.el' or by working with a file `subdirs.el'.
98
*ATTENTION*: ECB is NOT properly installed if it's directory is not added
99
to `load-path' and for example just loaded by
101
(load-file "/path/to/ecb/ecb.el")
105
4. Load ECB by adding code to your `.emacs':
107
If you want to load the complete ECB at (X)Emacs-loadtime (Advantage: All
108
ECB-options available after loading ECB). Disadvantage: Increasing
113
If you want to load the ECB first after starting it by `ecb-activate'
114
(Advantage: Fast loading. Disadvantage: ECB- and semantic-options first
115
available after starting ECB):
117
(require 'ecb-autoloads)
119
This loads all available autoloads (e.g. `ecb-activate', `ecb-minor-mode',
120
`ecb-show-help' or `ecb-byte-compile') of current ECB.
124
ECB is now ready for use and can be activated by calling `M-x ecb-activate' or
125
`ecb-minor-mode'. Now you can either starting using ECB or you can do these
126
optional installation steps:
128
6. Reading the online help with `ecb-show-help'
130
Maybe you are interested to read the online-help of ECB before first start.
132
7. Calling `ecb-byte-compile'
134
This byte compiles ECB. You can safely ignore all messages. (You can also
135
byte-compile ECB from the command-line either by using the `Makefile' or by
136
using the batch-file `make.bat'. Just read the comments in that file you
139
8. Installing the supplied `ecb.info'
141
The ECB distribution contains a subdirectory "info-help" which contains the
142
online-help of ECB in Info-format. You can install this online help so it's
143
available in the Top-directory of Info. There are two ways to do this:
145
- Use "install-info" (recommended):
147
1. Copy the the files of the subdirectory "info-help" into the
148
info-directory of Emacs
150
2. Install the file "info-help/ecb.info" with the command "install-info"
151
(if available on your system) in the `dir'-file.
153
The supplied `Makefile' offers a target `install-help' which does both of
154
these steps. You have just to call `make install-help' with the correct
155
EMACSINFOPATH set (see the comment in `Makefile'). Here is an example:
157
make EMACSINFOPATH=/path/to/emacs/info install-help
159
- Manual Installation:
161
Copy the files of the subdirectory "info-help" into the info-directory of
162
Emacs and modify the file `dir' manually.
164
But it doesn't matter if you do not execute this step (8.) because the
165
online help of ECB is always available though, see `ecb-show-help'.
171
Call "M-x ecb-activate" to activated ECB.
173
Call "M-x ecb-customize-most-important" to get a list of the most important
174
options of ECB. These are options you should at least know that they exist.
176
Call "M-x ecb-show-help" to get a detailed online-help for ECB. If you are
177
using ECB the first time you should read the online help accurately!
183
Send comments, bug reports and improvement suggestions to:
185
ecb-list@lists.sourceforge.net