~ubuntu-branches/debian/lenny/ecb/lenny

1 by Joerg Jaspert
Import upstream version 2.21
1
<html lang="en">
2
<head>
3
<title>ECB - the Emacs Code Browser</title>
4
<meta http-equiv="Content-Type" content="text/html">
5
<meta name=description content="ECB - the Emacs Code Browser">
6
<meta name=generator content="makeinfo 4.2">
7
<link href="http://www.gnu.org/software/texinfo/" rel=generator-home>
8
</head>
9
<body>
10
<p>
11
Node:<a name="FAQ">FAQ</a>,
12
Next:<a rel=next accesskey=n href="Command-Index.html#Command%20Index">Command Index</a>,
13
Previous:<a rel=previous accesskey=p href="Conflicts-and-bugs.html#Conflicts%20and%20bugs">Conflicts and bugs</a>,
14
Up:<a rel=up accesskey=u href="ecb.html#Top">Top</a>
15
<hr><br>
16
17
<h2>Frequently asked questions</h2>
18
19
<p>This is the Emacs Code Browser FAQ.
20
21
<p><table>
22
<tr align="left"><td valign="top"><strong>Question</strong>
23
</td><td valign="top"></td><td valign="top">
24
<strong>Answer</strong>
25
26
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
27
28
<br></td></tr><tr align="left"><td valign="top">What is the first step i should do if i have problems with ECB? 
29
</td><td valign="top"></td><td valign="top">
30
Read carefully the related sections of the online-help of ECB.
31
32
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
33
34
<br></td></tr><tr align="left"><td valign="top">What should i do, if a have a problem which can not be solved even
35
after reading the online-help? 
36
</td><td valign="top"></td><td valign="top">
37
Send a problem-report to the ECB-mailing-list with the command
38
<code>ecb-submit-problem-report</code>. 
39
See <a href="Submitting-problem-report.html#Submitting%20problem%20report">Submitting problem report</a>.
40
41
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
42
43
<br></td></tr><tr align="left"><td valign="top">What should i do, if another package seems not to work correct with
44
ECB? 
45
</td><td valign="top"></td><td valign="top">
46
Take a look into <a href="Conflicts.html#Conflicts">Conflicts</a>. If your package is not listed there
47
then submit a problem-report.
48
49
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
50
51
<br></td></tr><tr align="left"><td valign="top">Can ECB parse and display source-contents not supported by semantic? 
52
</td><td valign="top"></td><td valign="top">
53
Yes, in all version &gt;= 1.94. ECB can now parse and display all
54
source-contents supported by semantic, imenu or etags - same as
55
speedbar. See <a href="Non-semantic-sources.html#Non-semantic%20sources">Non-semantic sources</a>.
56
57
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
58
59
<br></td></tr><tr align="left"><td valign="top">Why are the lines in the ECB-, temp- and compilation-buffers not
60
wrapped but truncated? 
61
</td><td valign="top"></td><td valign="top">
62
Check the variable <code>truncate-partial-width-windows</code> and set it to
63
nil.
64
65
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
66
67
<br></td></tr><tr align="left"><td valign="top">Why doesn't ECB work correct with VC? 
68
</td><td valign="top"></td><td valign="top">
69
The variable <code>vc-delete-logbuf-window</code> must be set to nil during
70
active ECB. This can be done with the hooks of ECB.
71
72
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
73
74
<br></td></tr><tr align="left"><td valign="top">Does ECB support C++ as well as Java? 
75
</td><td valign="top"></td><td valign="top">
76
This depends strongly on the used semantic-version, but all
77
semantic-versions &gt;= semantic-1.4.3 support C++ really well.
78
79
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
80
81
<br></td></tr><tr align="left"><td valign="top">Does ECB support Perl? 
82
</td><td valign="top"></td><td valign="top">
83
If perl can be parsed either by imenu, etags or semantic then ECB
84
supports perl. Of course ECB would support perl best if perl is
85
supported by semantic.
86
87
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
88
89
<br></td></tr><tr align="left"><td valign="top">Does ECB support language XYZ? 
90
</td><td valign="top"></td><td valign="top">
91
See question "Does ECB support Perl?" and replace "Perl" with
92
"XYZ" in the answer.
93
94
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
95
96
<br></td></tr><tr align="left"><td valign="top">How to add new languages to ECB? 
97
</td><td valign="top"></td><td valign="top">
98
Add the language XYZ to semantic (perform all necessary steps described in
99
the semantic-manual) and ECB will automatically support language XYZ! 
100
There is nothing to do in ECB itself! Same when you write an imenu- or
101
etags-support for language XYZ.
102
103
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
104
105
<br></td></tr><tr align="left"><td valign="top">Why does ECB not recognize my source-files for C++? 
106
</td><td valign="top"></td><td valign="top">
107
Your C++-files have probably an extension which is not mapped to
108
c++-mode in <code>auto-mode-alist</code> and/or your own Emacs-setup has
109
"destroyed" the correct value of the hook-variable
110
<code>c++-mode-hook</code>. 
111
See <a href="Setting-up-Emacs.html#Setting%20up%20Emacs">Setting up Emacs</a>.
112
113
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
114
115
<br></td></tr><tr align="left"><td valign="top">Why doesn't ECB display the node name in the echo area if mouse moves
116
over it? 
117
</td><td valign="top"></td><td valign="top">
118
There can be several reasons: First the value of the option
119
<code>ecb-show-node-name-in-minibuffer</code> must be either <code>always</code> or
120
<code>if-too-long</code>. If this is OK, then maybe you have turned on
121
follow-mouse AFTER activating ECB; follow-mouse must be turned on
122
BEFORE ECB is activated, e.g. in the <code>ecb-activate-hook</code>! But with
123
Emacs 21.X and XEmacs there are no problems with this feature, just
124
activate it.
125
126
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
127
128
<br></td></tr><tr align="left"><td valign="top">What is the reason for poor scrolling performance with GNU Emacs 20.X
129
in the edit-windows and what can i do? 
130
</td><td valign="top"></td><td valign="top">
131
Set <code>scroll-conservatively</code> to 0 and <code>scroll-step</code> to a
132
value &gt; 1. For the exact reason look at
133
<a href="Optimize-scrolling.html#Optimize%20scrolling">Optimize scrolling</a>.
134
135
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
136
137
<br></td></tr><tr align="left"><td valign="top">Is it possible to make the history of ECB persistent? 
138
</td><td valign="top"></td><td valign="top">
139
You can use the library "desktop.el" which works very well with ECB. 
140
Then all files of your recent Emacs-session will be opened
141
automatically after next Emacs-start and will be added automatically
142
to the ECB-history after ECB-start.
143
144
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
145
146
<br></td></tr><tr align="left"><td valign="top">Is there an "Intellisense"-mechanism like with other IDEs? 
147
</td><td valign="top"></td><td valign="top">
148
For Java the JDEE<a rel=footnote href="#fn-1"><sup>1</sup></a> has this feature and for all other languages
149
semantic offer something similar, see
150
<a href="http://cedet.sourceforge.net/intellisense.shtml">http://cedet.sourceforge.net/intellisense.shtml</a>
151
152
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
153
154
<br></td></tr><tr align="left"><td valign="top">Can i use ECB in combination with Gnus within one frame? 
155
</td><td valign="top"></td><td valign="top">
156
You can, but for ECB-versions &lt; 1.96 it is not recommended because
157
each of them has it's own window-management and probably there will be
158
conflicts, so use different frames for ECB and Gnus! But beginning
159
with ECB 1.96 you can use either escreen.el or winring.el as
160
"window-manager" which allows you in consequence to use ECB and
161
applications like Gnus in one frame! 
162
See <a href="Window-managers-and-ECB.html#Window-managers%20and%20ECB">Window-managers and ECB</a>.
163
164
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
165
166
<br></td></tr><tr align="left"><td valign="top">Can i speed up displaying the contents of big-size directories? 
167
</td><td valign="top"></td><td valign="top">
168
Yes, see the option <code>ecb-cache-directory-contents</code>. Read the
169
section
170
<a href="Large-directories.html#Large%20directories">Large directories</a>.
171
172
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
173
174
<br></td></tr><tr align="left"><td valign="top">Is it possible to create/use other layouts than the built-in ones? 
175
</td><td valign="top"></td><td valign="top">
176
Yes. <a href="Creating-a-new-ECB-layout.html#Creating%20a%20new%20ECB-layout">Creating a new ECB-layout</a> and
177
<a href="The-layout-engine.html#The%20layout-engine">The layout-engine</a> are the relevant sections. The former one
178
describes how to create interactively new layouts where the latter
179
one is for Elisp-programmers.
180
181
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
182
183
<br></td></tr><tr align="left"><td valign="top">Can i use speedbar as directory-browser within ECB? 
184
</td><td valign="top"></td><td valign="top">
185
Yes, see <a href="Integrating-speedbar.html#Integrating%20speedbar">Integrating speedbar</a>.
186
187
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
188
189
<br></td></tr><tr align="left"><td valign="top">Can i exclude subdirectories from the recursive grep in the directories buffer? 
190
</td><td valign="top"></td><td valign="top">
191
Yes, see <a href="Grepping-directories.html#Grepping%20directories">Grepping directories</a>.
192
193
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
194
195
<br></td></tr><tr align="left"><td valign="top">How can i prevent contaminating each directory with a file <code>semantic-cache</code>? 
196
</td><td valign="top"></td><td valign="top">
197
Set <code>semanticdb-default-save-directory</code> to a directory.
198
199
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
200
201
<br></td></tr><tr align="left"><td valign="top">Why ECB displays large portions of current source-file with dark background? 
202
</td><td valign="top"></td><td valign="top">
203
This comes from semantic;
204
see <a href="Setting-up-Emacs.html#Setting%20up%20Emacs">Setting up Emacs</a>.
205
206
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
207
208
<br></td></tr><tr align="left"><td valign="top">Why ECB underlines some parts of current source-file? 
209
</td><td valign="top"></td><td valign="top">
210
This comes from semantic;
211
see <a href="Setting-up-Emacs.html#Setting%20up%20Emacs">Setting up Emacs</a>.
212
213
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
214
215
<br></td></tr><tr align="left"><td valign="top">Can i add my own commands to the popup-menus of tree-buffers? 
216
</td><td valign="top"></td><td valign="top">
217
Yes, see <a href="Using-the-mouse.html#Using%20the%20mouse">Using the mouse</a>.
218
219
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
220
221
<br></td></tr><tr align="left"><td valign="top">Can ECB display the compile-window "on demand"? 
222
</td><td valign="top"></td><td valign="top">
223
Yes, see <a href="Tips-and-tricks.html#Tips%20and%20tricks">Tips and tricks</a>.
224
225
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
226
227
<br></td></tr><tr align="left"><td valign="top">Which buffers are treated as compilation-buffers by ECB? 
228
</td><td valign="top"></td><td valign="top">
229
See the docstring of the function <code>ecb-compilation-buffer-p</code>.
230
231
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
232
233
<br></td></tr><tr align="left"><td valign="top">How can i change the modeline of an ECB-tree-buffer? 
234
</td><td valign="top"></td><td valign="top">
235
You can change it with the options <code>ecb-mode-line-prefixes</code>,
236
<code>ecb-mode-line-data</code> and
237
<code>ecb-mode-line-display-window-number</code>.
238
239
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
240
241
<br></td></tr><tr align="left"><td valign="top">Can the tree-buffers being selected faster than with the
242
standard-keybindings of ECB? 
243
</td><td valign="top"></td><td valign="top">
244
Yes, see option <code>ecb-mode-line-display-window-number</code>.
245
246
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
247
248
<br></td></tr><tr align="left"><td valign="top">Can ECB display the window-number in the modeline of the special windows? 
249
</td><td valign="top"></td><td valign="top">
250
Yes, see option <code>ecb-mode-line-display-window-number</code>.
251
252
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
253
254
<br></td></tr><tr align="left"><td valign="top">How can i change the keybindings of ECB? 
255
</td><td valign="top"></td><td valign="top">
256
You can do this with option <code>ecb-key-map</code> (see <a href="ecb-general.html#ecb-general">ecb-general</a>).
257
258
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
259
260
<br></td></tr><tr align="left"><td valign="top">What can i do if hiding/showing from the methods-buffer does not work? 
261
</td><td valign="top"></td><td valign="top">
262
Either the current <code>major-modes</code> is not supported by hideshow or
263
you have to add an entry to <code>hs-special-modes-alist</code>
264
(see <a href="Hide-show.html#Hide-show">Hide-show</a>).
265
266
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
267
268
<br></td></tr><tr align="left"><td valign="top">Can i maximize one of the ECB-windows for better overlook? 
269
</td><td valign="top"></td><td valign="top">
270
Yes, see <a href="Maximizing-the-ECB-windows.html#Maximizing%20the%20ECB%20windows">Maximizing the ECB windows</a>.
271
272
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
273
274
<br></td></tr><tr align="left"><td valign="top">Can i hide the ECB-windows for getting more editing-space? 
275
</td><td valign="top"></td><td valign="top">
276
Yes, see <a href="Hiding-the-ECB-windows.html#Hiding%20the%20ECB%20windows">Hiding the ECB windows</a>.
277
278
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
279
280
<br></td></tr><tr align="left"><td valign="top">Can i define the actions ECB performs after visiting a tag? 
281
</td><td valign="top"></td><td valign="top">
282
Yes, see <a href="Visiting-tags.html#Visiting%20tags">Visiting tags</a>.
283
284
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
285
286
<br></td></tr><tr align="left"><td valign="top">Buffers are not displayed correctly in the compile-window? 
287
</td><td valign="top"></td><td valign="top">
288
See <a href="Problems-with-the-compile-window.html#Problems%20with%20the%20compile%20window">Problems with the compile window</a>.
289
290
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
291
292
<br></td></tr><tr align="left"><td valign="top">Can ECB work together with window-managers like escreen.el? 
293
</td><td valign="top"></td><td valign="top">
294
Yes, see <a href="Window-managers-and-ECB.html#Window-managers%20and%20ECB">Window-managers and ECB</a>.
295
296
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
297
298
<br></td></tr><tr align="left"><td valign="top">Can i remove these "ugly" vertical lines from a tree-buffer? 
299
</td><td valign="top"></td><td valign="top">
300
Yes, see option <code>ecb-tree-buffer-style</code>.
301
302
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
303
304
<br></td></tr><tr align="left"><td valign="top">ECB does not display images in the tree-buffers - what can i do? 
305
</td><td valign="top"></td><td valign="top">
306
Customize <code>ecb-tree-buffer-style</code> and restart ECB. But note: GNU
307
Emacs &lt;= 21.3.X for Windows does not support image-display so ECB uses
308
always ascii-guide-lines even when here the image-style is set in
309
<code>ecb-tree-buffer-style</code>.
310
311
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
312
313
<br></td></tr><tr align="left"><td valign="top">Do <code>special-display-function</code> et. al. work with ECB. 
314
</td><td valign="top"></td><td valign="top">
315
Yes, see
316
<a href="Using-special-display-with-ECB.html#Using%20special-display%20with%20ECB">Using special-display with ECB</a>.
317
318
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
319
320
<br></td></tr><tr align="left"><td valign="top">Can i activate the popup-menu of a tree-buffer from keyboard? 
321
</td><td valign="top"></td><td valign="top">
322
Yes, see <a href="Using-popup-menus.html#Using%20popup-menus">Using popup-menus</a>.
323
324
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
325
326
<br></td></tr><tr align="left"><td valign="top">Can i display the popup-menu of a tree-buffer with tmm? 
327
</td><td valign="top"></td><td valign="top">
328
Yes, see <a href="Using-popup-menus.html#Using%20popup-menus">Using popup-menus</a>.
329
330
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
331
332
<br></td></tr><tr align="left"><td valign="top">Does ECB disable all advices after deactivation? 
333
</td><td valign="top"></td><td valign="top">
334
"Nes"<a rel=footnote href="#fn-2"><sup>2</sup></a>, see remarks
335
in the documentation of the option
336
<code>ecb-split-edit-window-after-start</code>.
337
338
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
339
340
<br></td></tr><tr align="left"><td valign="top">Can ECB preserve the full state of ECB between deactivation and next
341
activation? 
342
</td><td valign="top"></td><td valign="top">
343
Yes, see the option <code>ecb-split-edit-window-after-start</code>.
344
345
<br></td></tr><tr align="left"><td valign="top"></td><td valign="top"></td><td valign="top">
346
347
<br></td></tr><tr align="left"><td valign="top">Can i change the behavior how ECB chooses another window for selecting
348
it or scrolling it. 
349
</td><td valign="top"></td><td valign="top">
350
Yes, see <a href="The-other-window.html#The%20other%20window">The other window</a>.
351
352
<br></td></tr></table>
353
354
<hr><h4>Footnotes</h4>
355
<ol type="1">
356
<li><a name="fn-1"></a>
357
<p>
358
<a href="http://jdee.sunsite.dk/">http://jdee.sunsite.dk/</a>
359
</p>
360
361
<li><a name="fn-2"></a>
362
<p>Nes is a combination of No and Yes :-)</p>
363
364
</ol><hr>
365
366
</body></html>
367