0
|
1 \input texinfo.tex @c -*-texinfo-*-
|
|
2 @c %**start of header
|
290
|
3 @setfilename ../info/xemacs-faq.info
|
0
|
4 @settitle Frequently asked questions about XEmacs
|
|
5 @setchapternewpage off
|
|
6 @c %**end of header
|
274
|
7 @finalout
|
0
|
8 @titlepage
|
|
9 @title XEmacs FAQ
|
298
|
10 @subtitle Frequently asked questions about XEmacs @* Last Modified: $Date: 1998/06/30 06:35:33 $
|
0
|
11 @sp 1
|
98
|
12 @author Tony Rossini <arossini@@stat.sc.edu>
|
169
|
13 @author Ben Wing <wing@@666.com>
|
215
|
14 @author Chuck Thompson <cthomp@@xemacs.org>
|
|
15 @author Steve Baur <steve@@xemacs.org>
|
126
|
16 @author Andreas Kaempf <andreas@@sccon.com>
|
274
|
17 @author Christian Nyb@o{} <chr@@mediascience.no>
|
0
|
18 @page
|
|
19 @end titlepage
|
|
20
|
82
|
21 @node Top, Introduction, (dir), (dir)
|
|
22 @top XEmacs FAQ
|
282
|
23 @unnumbered Introduction
|
82
|
24
|
|
25 This is the guide to the XEmacs Frequently Asked Questions list---a
|
|
26 compendium of questions and answers pertaining to one of the finest
|
|
27 programs ever written. It is much more than just a Text Editor.
|
|
28
|
|
29 This FAQ is freely redistributable. I take no liability for the
|
|
30 correctness and safety of any procedures or advice given here. This
|
|
31 FAQ is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
32 WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
33 FITNESS FOR A PARTICULAR PURPOSE.
|
|
34
|
|
35 If you have a Web browser, the official hypertext version is at
|
282
|
36 @iftex
|
|
37 @*
|
|
38 @end iftex
|
|
39 @uref{http://www.xemacs.org/faq/xemacs-faq.html}.
|
274
|
40
|
|
41 This version is somewhat nicer than the unofficial hypertext versions
|
|
42 that are archived at Utrecht, Oxford, Smart Pages, and other FAQ
|
|
43 archives.
|
0
|
44
|
282
|
45 @ifset CANONICAL
|
|
46 @html
|
|
47 This document is available in several different formats:
|
|
48 @itemize @bullet
|
|
49 @item
|
|
50 @uref{xemacs-faq.txt, As a single ASCII file}, produced by
|
|
51 @code{makeinfo --no-headers}
|
|
52 @item
|
|
53 @uref{xemacs-faq.dvi, As a .dvi file}, as used with
|
|
54 @uref{http://www.tug.org, TeX.}
|
|
55 @item
|
|
56 As a PostScript file @uref{xemacs-faq-a4.ps, in A4 format},
|
|
57 as well as in @uref{xemacs-faq-letter.ps, letter format}
|
|
58 @item
|
|
59 In html format, @uref{xemacs-faq_1.html, split by chapter}, or in
|
|
60 @uref{xemacs-faq.html, one monolithic} document.
|
|
61 @item
|
|
62 The canonical version of the FAQ is the texinfo document
|
|
63 @uref{xemacs-faq.texi, man/xemacs-faq.texi}.
|
|
64 @item
|
|
65 If you do not have makeinfo installed, you may @uref{xemacs-faq.info,
|
|
66 download the faq} in info format, and install it in @file{<XEmacs
|
|
67 libarary directory>/info/}. For example in
|
|
68 @file{/usr/local/lib/xemacs-20.4/info/}.
|
|
69
|
|
70 @end itemize
|
|
71
|
|
72 @end html
|
|
73
|
|
74 @end ifset
|
|
75
|
|
76 @c end ifset points to CANONICAL
|
|
77
|
0
|
78 @menu
|
82
|
79 * Introduction:: Introduction, Policy, Credits.
|
|
80 * Installation:: Installation and Trouble Shooting.
|
|
81 * Customization:: Customization and Options.
|
|
82 * Subsystems:: Major Subsystems.
|
|
83 * Miscellaneous:: The Miscellaneous Stuff.
|
|
84 * Current Events:: What the Future Holds.
|
207
|
85
|
|
86 @detailmenu
|
|
87
|
|
88 --- The Detailed Node Listing ---
|
|
89
|
|
90 Introduction, Policy, Credits
|
|
91
|
|
92 * Q1.0.1:: What is XEmacs?
|
|
93 * Q1.0.2:: What is the current version of XEmacs?
|
|
94 * Q1.0.3:: Where can I find it?
|
|
95 * Q1.0.4:: Why Another Version of Emacs?
|
|
96 * Q1.0.5:: Why Haven't XEmacs and GNU Emacs Merged?
|
282
|
97 * Q1.0.6:: Where can I get help?
|
207
|
98 * Q1.0.7:: Where is the mailing list archived?
|
|
99 * Q1.0.8:: How do you pronounce XEmacs?
|
282
|
100 * Q1.0.9:: What does XEmacs look like?
|
207
|
101 * Q1.0.10:: Is there a port of XEmacs to Microsoft ('95 or NT)?
|
|
102 * Q1.0.11:: Is there a port of XEmacs to the Macintosh?
|
|
103 * Q1.0.12:: Is there a port of XEmacs to NextStep?
|
|
104 * Q1.0.13:: Is there a port of XEmacs to OS/2?
|
|
105 * Q1.0.14:: Where can I get a printed copy of the XEmacs users manual?
|
|
106
|
|
107 Policies:
|
|
108 * Q1.1.1:: What is the FAQ editorial policy?
|
|
109 * Q1.1.2:: How do I become a Beta Tester?
|
|
110 * Q1.1.3:: How do I contribute to XEmacs itself?
|
|
111
|
|
112 Credits:
|
|
113 * Q1.2.1:: Who wrote XEmacs?
|
282
|
114 * Q1.2.2:: Who contributed to this version of the FAQ?
|
|
115 * Q1.2.3:: Who contributed to the FAQ in the past?
|
207
|
116
|
|
117 Internationalization:
|
282
|
118 * Q1.3.1:: What is the status of XEmacs v20?
|
207
|
119 * Q1.3.2:: What is the status of Asian-language support, aka @var{mule}?
|
|
120 * Q1.3.3:: How do I type non-ASCII characters?
|
|
121 * Q1.3.4:: Can XEmacs messages come out in a different language?
|
|
122 * Q1.3.5:: Please explain the various input methods in MULE/XEmacs 20.0
|
|
123 * Q1.3.6:: How do I portably code for MULE/XEmacs 20.0?
|
282
|
124 * Q1.3.7:: How about Cyrillic Modes?
|
207
|
125
|
|
126 Getting Started:
|
|
127 * Q1.4.1:: What is a @file{.emacs} and is there a sample one?
|
|
128 * Q1.4.2:: Can I use the same @file{.emacs} with the other Emacs?
|
|
129 * Q1.4.3:: Any good XEmacs tutorials around?
|
|
130 * Q1.4.4:: May I see an example of a useful XEmacs Lisp function?
|
|
131 * Q1.4.5:: And how do I bind it to a key?
|
|
132 * Q1.4.6:: What's the difference between a macro and a function?
|
|
133 * Q1.4.7:: Why options saved with 19.13 don't work with 19.14 or later?
|
|
134
|
|
135 Installation and Trouble Shooting
|
|
136
|
282
|
137 * Q2.0.1:: Running XEmacs without installing.
|
|
138 * Q2.0.2:: XEmacs is too big.
|
207
|
139 * Q2.0.3:: Compiling XEmacs with Netaudio.
|
|
140 * Q2.0.4:: Problems with Linux and ncurses.
|
|
141 * Q2.0.5:: Do I need X11 to run XEmacs?
|
|
142 * Q2.0.6:: I'm having strange crashes. What do I do?
|
|
143 * Q2.0.7:: Libraries in non-standard locations.
|
|
144 * Q2.0.8:: can't resolve symbol _h_errno
|
282
|
145 * Q2.0.9:: Where do I find external libraries?
|
207
|
146 * Q2.0.10:: After I run configure I find a coredump, is something wrong?
|
|
147 * Q2.0.11:: XEmacs can't resolve host names.
|
282
|
148 * Q2.0.12:: Why can't I strip XEmacs?
|
207
|
149 * Q2.0.13:: Can't link XEmacs on Solaris with Gcc.
|
282
|
150 * Q2.0.14:: Make on HP/UX 9 fails after linking temacs
|
207
|
151
|
|
152 Trouble Shooting:
|
|
153 * Q2.1.1:: XEmacs just crashed on me!
|
|
154 * Q2.1.2:: Cryptic Minibuffer messages.
|
|
155 * Q2.1.3:: Translation Table Syntax messages at Startup.
|
|
156 * Q2.1.4:: Startup warnings about deducing proper fonts?
|
|
157 * Q2.1.5:: XEmacs cannot connect to my X Terminal.
|
|
158 * Q2.1.6:: XEmacs just locked up my Linux X server.
|
|
159 * Q2.1.7:: HP Alt key as Meta.
|
|
160 * Q2.1.8:: got (wrong-type-argument color-instance-p nil)!
|
|
161 * Q2.1.9:: XEmacs causes my OpenWindows 3.0 server to crash.
|
|
162 * Q2.1.10:: Warnings from incorrect key modifiers.
|
282
|
163 * Q2.1.11:: Can't instantiate image error... in toolbar
|
207
|
164 * Q2.1.12:: Regular Expression Problems on DEC OSF1.
|
|
165 * Q2.1.13:: HP/UX 10.10 and @code{create_process} failure
|
|
166 * Q2.1.14:: @kbd{C-g} doesn't work for me. Is it broken?
|
|
167 * Q2.1.15:: How to debug an XEmacs problem with a debugger.
|
|
168 * Q2.1.16:: XEmacs crashes in @code{strcat} on HP/UX 10.
|
|
169 * Q2.1.17:: @samp{Marker does not point anywhere}.
|
|
170 * Q2.1.18:: 19.14 hangs on HP/UX 10.10.
|
|
171 * Q2.1.19:: XEmacs does not follow the local timezone.
|
|
172 * Q2.1.20:: @samp{Symbol's function definition is void: hkey-help-show.}
|
|
173 * Q2.1.21:: Every so often the XEmacs frame freezes.
|
|
174 * Q2.1.22:: XEmacs seems to take a really long time to do some things.
|
|
175 * Q2.1.23:: Movemail on Linux does not work for XEmacs 19.15 and later.
|
|
176
|
|
177 Customization and Options
|
|
178
|
282
|
179 * Q3.0.1:: What version of Emacs am I running?
|
207
|
180 * Q3.0.2:: How do I evaluate Elisp expressions?
|
|
181 * Q3.0.3:: @code{(setq tab-width 6)} behaves oddly.
|
|
182 * Q3.0.4:: How can I add directories to the @code{load-path}?
|
|
183 * Q3.0.5:: How to check if a lisp function is defined?
|
|
184 * Q3.0.6:: Can I force the output of @code{(face-list)} to a buffer?
|
282
|
185 * Q3.0.7:: Font selections don't get saved after @code{Save Options}.
|
207
|
186 * Q3.0.8:: How do I make a single minibuffer frame?
|
217
|
187 * Q3.0.9:: What is @code{Customize}?
|
207
|
188
|
|
189 X Window System & Resources:
|
|
190 * Q3.1.1:: Where is a list of X resources?
|
|
191 * Q3.1.2:: How can I detect a color display?
|
|
192 * Q3.1.3:: @code{(set-screen-width)} worked in 19.6, but not in 19.13?
|
217
|
193 * Q3.1.4:: Specifying @code{Emacs*EmacsScreen.geometry} in @file{.emacs} does not work in 19.15?
|
207
|
194 * Q3.1.5:: How can I get the icon to just say @samp{XEmacs}?
|
|
195 * Q3.1.6:: How can I have the window title area display the full path?
|
|
196 * Q3.1.7:: @samp{xemacs -name junk} doesn't work?
|
282
|
197 * Q3.1.8:: @samp{-iconic} doesn't work.
|
207
|
198
|
|
199 Textual Fonts & Colors:
|
|
200 * Q3.2.1:: How can I set color options from @file{.emacs}?
|
|
201 * Q3.2.2:: How do I set the text, menu and modeline fonts?
|
|
202 * Q3.2.3:: How can I set the colors when highlighting a region?
|
282
|
203 * Q3.2.4:: How can I limit color map usage?
|
207
|
204 * Q3.2.5:: My tty supports color, but XEmacs doesn't use them.
|
282
|
205 * Q3.2.6:: Can I have pixmap backgrounds in XEmacs?
|
207
|
206
|
|
207 The Modeline:
|
|
208 * Q3.3.1:: How can I make the modeline go away?
|
|
209 * Q3.3.2:: How do you have XEmacs display the line number in the modeline?
|
|
210 * Q3.3.3:: How do I get XEmacs to put the time of day on the modeline?
|
|
211 * Q3.3.4:: How do I turn off current chapter from AUC TeX modeline?
|
|
212 * Q3.3.5:: How can one change the modeline color based on the mode used?
|
|
213
|
282
|
214 Multiple Device Support:
|
|
215 * Q3.4.1:: How do I open a frame on another screen of my multi-headed display?
|
207
|
216 * Q3.4.2:: Can I really connect to a running XEmacs after calling up over a modem? How?
|
|
217
|
282
|
218 The Keyboard:
|
207
|
219 * Q3.5.1:: How can I bind complex functions (or macros) to keys?
|
|
220 * Q3.5.2:: How can I stop down-arrow from adding empty lines to the bottom of my buffers?
|
|
221 * Q3.5.3:: How do I bind C-. and C-; to scroll one line up and down?
|
|
222 * Q3.5.4:: Globally binding @kbd{Delete}?
|
|
223 * Q3.5.5:: Scrolling one line at a time.
|
282
|
224 * Q3.5.6:: How to map @kbd{Help} key alone on Sun type4 keyboard?
|
207
|
225 * Q3.5.7:: How can you type in special characters in XEmacs?
|
|
226 * Q3.5.8:: Why does @code{(global-set-key [delete-forward] 'delete-char)} complain?
|
|
227 * Q3.5.9:: How do I make the Delete key delete forward?
|
|
228 * Q3.5.10:: Can I turn on @dfn{sticky} modifier keys?
|
282
|
229 * Q3.5.11:: How do I map the arrow keys?
|
207
|
230
|
|
231 The Cursor:
|
|
232 * Q3.6.1:: Is there a way to make the bar cursor thicker?
|
|
233 * Q3.6.2:: Is there a way to get back the old block cursor where the cursor covers the character in front of the point?
|
|
234 * Q3.6.3:: Can I make the cursor blink?
|
|
235
|
|
236 The Mouse and Highlighting:
|
|
237 * Q3.7.1:: How can I turn off Mouse pasting?
|
|
238 * Q3.7.2:: How do I set control/meta/etc modifiers on mouse buttons?
|
|
239 * Q3.7.3:: Clicking the left button does not do anything in buffer list.
|
|
240 * Q3.7.4:: How can I get a list of buffers when I hit mouse button 3?
|
|
241 * Q3.7.5:: Why does cut-and-paste not work between XEmacs and a cmdtool?
|
|
242 * Q3.7.6:: How I can set XEmacs up so that it pastes where the text cursor is?
|
|
243 * Q3.7.7:: How do I select a rectangular region?
|
|
244 * Q3.7.8:: Why does @kbd{M-w} take so long?
|
|
245
|
|
246 The Menubar and Toolbar:
|
|
247 * Q3.8.1:: How do I get rid of the menu (or menubar)?
|
|
248 * Q3.8.2:: Can I customize the basic menubar?
|
|
249 * Q3.8.3:: How do I control how many buffers are listed in the menu @code{Buffers} list?
|
|
250 * Q3.8.4:: Resources like @code{Emacs*menubar*font} are not working?
|
|
251 * Q3.8.5:: How can I bind a key to a function to toggle the toolbar?
|
|
252
|
|
253 Scrollbars:
|
|
254 * Q3.9.1:: How can I disable the scrollbar?
|
|
255 * Q3.9.2:: How can one use resources to change scrollbar colors?
|
|
256 * Q3.9.3:: Moving the scrollbar can move the point; can I disable this?
|
|
257 * Q3.9.4:: How can I get automatic horizontal scrolling?
|
|
258
|
|
259 Text Selections:
|
282
|
260 * Q3.10.1:: How can I turn off or change highlighted selections?
|
207
|
261 * Q3.10.2:: How do I get that typing on an active region removes it?
|
|
262 * Q3.10.3:: Can I turn off the highlight during isearch?
|
|
263 * Q3.10.4:: How do I turn off highlighting after @kbd{C-x C-p} (mark-page)?
|
|
264 * Q3.10.5:: The region disappears when I hit the end of buffer while scrolling.
|
|
265
|
|
266 Major Subsystems
|
|
267
|
|
268 * Q4.0.1:: How do I set up VM to retrieve remote mail using POP?
|
|
269 * Q4.0.2:: How do I get VM to filter mail for me?
|
|
270 * Q4.0.3:: How can I get VM to automatically check for new mail?
|
|
271 * Q4.0.4:: [This question intentionally left blank]
|
|
272 * Q4.0.5:: How do I get my outgoing mail archived?
|
|
273 * Q4.0.6:: I have various addresses at which I receive mail. How can I tell VM to ignore them when doing a "reply-all"?
|
|
274 * Q4.0.7:: Is there a mailing list or FAQ for VM?
|
217
|
275 * Q4.0.8:: Remote mail reading with VM.
|
207
|
276 * Q4.0.9:: rmail or VM gets an error incorporating new mail.
|
|
277 * Q4.0.10:: How do I make VM stay in a single frame?
|
|
278 * Q4.0.11:: How do I make VM or mh-e display graphical smilies?
|
|
279 * Q4.0.12:: Customization of VM not covered in the manual or here.
|
|
280
|
|
281 Web browsing with W3:
|
|
282 * Q4.1.1:: What is W3?
|
|
283 * Q4.1.2:: How do I run W3 from behind a firewall?
|
|
284 * Q4.1.3:: Is it true that W3 supports style sheets and tables?
|
|
285
|
|
286 Reading Netnews and Mail with Gnus:
|
282
|
287 * Q4.2.1:: GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus, Quassia Gnus, argh!
|
207
|
288 * Q4.2.2:: [This question intentionally left blank]
|
|
289 * Q4.2.3:: How do I make Gnus stay within a single frame?
|
|
290 * Q4.2.4:: How do I customize the From: line?
|
|
291
|
|
292 Other Mail & News:
|
|
293 * Q4.3.1:: How can I read and/or compose MIME messages?
|
|
294 * Q4.3.2:: What is TM and where do I get it?
|
|
295 * Q4.3.3:: Why isn't this @code{movemail} program working?
|
|
296 * Q4.3.4:: Movemail is also distributed by Netscape? Can that cause problems?
|
|
297 * Q4.3.5:: Where do I find pstogif (required by tm)?
|
|
298
|
|
299 Sparcworks, EOS, and WorkShop:
|
282
|
300 * Q4.4.1:: What is SPARCworks, EOS, and WorkShop
|
207
|
301
|
|
302 Energize:
|
|
303 * Q4.5.1:: What is/was Energize?
|
|
304
|
|
305 Infodock:
|
|
306 * Q4.6.1:: What is Infodock?
|
|
307
|
|
308 Other Unbundled Packages:
|
|
309 * Q4.7.1:: What is AUC TeX? Where do you get it?
|
|
310 * Q4.7.2:: Are there any Emacs Lisp Spreadsheets?
|
|
311 * Q4.7.3:: Byte compiling AUC TeX on XEmacs 19.14
|
|
312 * Q4.7.4:: Problems installing AUC TeX
|
|
313 * Q4.7.5:: Is there a reason for an Emacs package not to be included in XEmacs?
|
282
|
314 * Q4.7.6:: Is there a MatLab mode?
|
207
|
315
|
|
316 The Miscellaneous Stuff
|
|
317
|
|
318 * Q5.0.1:: How can I do source code highlighting using font-lock?
|
|
319 * Q5.0.2:: I do not like cc-mode. How do I use the old c-mode?
|
|
320 * Q5.0.3:: How do I get @samp{More} Syntax Highlighting on by default?
|
|
321 * Q5.0.4:: How can I enable auto-indent?
|
|
322 * Q5.0.5:: How can I get XEmacs to come up in text/auto-fill mode by default?
|
|
323 * Q5.0.6:: How do I start up a second shell buffer?
|
|
324 * Q5.0.7:: Telnet from shell filters too much.
|
|
325 * Q5.0.8:: Why does edt emulation not work?
|
|
326 * Q5.0.9:: How can I emulate VI and use it as my default mode?
|
282
|
327 * Q5.0.10:: [This question intentionally left blank]
|
|
328 * Q5.0.11:: Filladapt doesn't work in 19.15?
|
207
|
329 * Q5.0.12:: How do I disable gnuserv from opening a new frame?
|
|
330 * Q5.0.13:: How do I start gnuserv so that each subsequent XEmacs is a client?
|
|
331 * Q5.0.14:: Strange things are happening in Shell Mode.
|
|
332 * Q5.0.15:: Where do I get the latest CC Mode?
|
|
333 * Q5.0.16:: I find auto-show-mode disconcerting. How do I turn it off?
|
|
334 * Q5.0.17:: How can I get two instances of info?
|
|
335 * Q5.0.18:: I upgraded to XEmacs 19.14 and gnuserv stopped working
|
|
336 * Q5.0.19:: Is there something better than LaTeX mode?
|
274
|
337 * Q5.0.20:: Is there a way to start a new XEmacs if there's no gnuserv running, and otherwise use gnuclient?
|
207
|
338
|
|
339 Emacs Lisp Programming Techniques:
|
|
340 * Q5.1.1:: The difference in key sequences between XEmacs and GNU Emacs?
|
|
341 * Q5.1.2:: Can I generate "fake" keyboard events?
|
|
342 * Q5.1.3:: Could you explain @code{read-kbd-macro} in more detail?
|
|
343 * Q5.1.4:: What is the performance hit of @code{let}?
|
|
344 * Q5.1.5:: What is the recommended use of @code{setq}?
|
|
345 * Q5.1.6:: What is the typical misuse of @code{setq} ?
|
|
346 * Q5.1.7:: I like the the @code{do} form of cl, does it slow things down?
|
|
347 * Q5.1.8:: I like recursion, does it slow things down?
|
|
348 * Q5.1.9:: How do I put a glyph as annotation in a buffer?
|
282
|
349 * Q5.1.10:: @code{map-extents} won't traverse all of my extents!
|
|
350 * Q5.1.11:: My elisp program is horribly slow. Is there an easy way to find out where it spends time?
|
207
|
351
|
|
352 Sound:
|
|
353 * Q5.2.1:: How do I turn off the sound?
|
|
354 * Q5.2.2:: How do I get funky sounds instead of a boring beep?
|
|
355 * Q5.2.3:: What's NAS, how do I get it?
|
|
356 * Q5.2.4:: Sunsite sounds don't play.
|
|
357
|
|
358 Miscellaneous:
|
|
359 * Q5.3.1:: How do you make XEmacs indent CL if-clauses correctly?
|
|
360 * Q5.3.2:: Fontifying hangs when editing a postscript file.
|
|
361 * Q5.3.3:: How can I print WYSIWYG a font-locked buffer?
|
|
362 * Q5.3.4:: Getting @kbd{M-x lpr} to work with postscript printer.
|
|
363 * Q5.3.5:: How do I specify the paths that XEmacs uses for finding files?
|
|
364 * Q5.3.6:: [This question intentionally left blank]
|
|
365 * Q5.3.7:: Can I have the end of the buffer delimited in some way?
|
|
366 * Q5.3.8:: How do I insert today's date into a buffer?
|
|
367 * Q5.3.9:: Are only certain syntactic character classes available for abbrevs?
|
|
368 * Q5.3.10:: How can I get those oh-so-neat X-Face lines?
|
|
369 * Q5.3.11:: How do I add new Info directories?
|
|
370 * Q5.3.12:: What do I need to change to make printing work?
|
|
371
|
|
372 What the Future Holds
|
|
373
|
|
374 * Q6.0.1:: What is new in 20.2?
|
|
375 * Q6.0.2:: What is new in 20.3?
|
274
|
376 * Q6.0.3:: What is new in 20.4?
|
|
377 * Q6.0.4:: Procedural changes in XEmacs development.
|
207
|
378 @end detailmenu
|
70
|
379 @end menu
|
|
380
|
82
|
381 @node Introduction, Installation, Top, Top
|
274
|
382 @unnumbered 1 Introduction, Policy, Credits
|
|
383
|
|
384 Learning XEmacs is a lifelong activity. Even people who have used Emacs
|
|
385 for years keep discovering new features. Therefore this document cannot
|
|
386 be complete. Instead it is aimed at the person who is either
|
|
387 considering XEmacs for their own use, or has just obtained it and is
|
|
388 wondering what to do next. It is also useful as a reference to
|
|
389 available resources.
|
|
390
|
|
391 The previous maintainer of the FAQ was @email{rossini@@stat.sc.edu,
|
|
392 Anthony Rossini}, who started it, after getting tired of hearing JWZ
|
|
393 complain about repeatedly having to answer questions.
|
|
394 @email{ben@@666.com, Ben Wing} and @email{cthomp@@xemacs.org, Chuck
|
|
395 Thompson}, the principal authors of XEmacs, then took over and Ben did
|
|
396 a massive update reorganizing the whole thing. At which point Anthony
|
|
397 took back over, but then had to give it up again. Some of the other
|
|
398 contributors to this FAQ are listed later in this document.
|
82
|
399
|
116
|
400 The previous version was converted to hypertext format, and edited by
|
274
|
401 @email{steve@@altair.xemacs.org, Steven L. Baur}. It was converted back to
|
|
402 texinfo by @email{hniksic@@srce.hr, Hrvoje Niksic}.
|
|
403
|
|
404 The FAQ was then maintained by @email{andreas@@sccon.com, Andreas
|
282
|
405 Kaempf}, who passed it on to @email{faq@@xemacs.org, Christian
|
274
|
406 Nyb@o{}}, the current FAQ maintainer.
|
|
407
|
|
408 If you notice any errors or items which should be added or amended to
|
282
|
409 this FAQ please send email to @email{faq@@xemacs.org, Christian
|
274
|
410 Nyb@o{}}. Include @samp{XEmacs FAQ} on the Subject: line.
|
70
|
411
|
|
412 @menu
|
82
|
413 Introduction:
|
|
414 * Q1.0.1:: What is XEmacs?
|
|
415 * Q1.0.2:: What is the current version of XEmacs?
|
|
416 * Q1.0.3:: Where can I find it?
|
|
417 * Q1.0.4:: Why Another Version of Emacs?
|
|
418 * Q1.0.5:: Why Haven't XEmacs and GNU Emacs Merged?
|
282
|
419 * Q1.0.6:: Where can I get help?
|
82
|
420 * Q1.0.7:: Where is the mailing list archived?
|
|
421 * Q1.0.8:: How do you pronounce XEmacs?
|
282
|
422 * Q1.0.9:: What does XEmacs look like?
|
82
|
423 * Q1.0.10:: Is there a port of XEmacs to Microsoft ('95 or NT)?
|
|
424 * Q1.0.11:: Is there a port of XEmacs to the Macintosh?
|
|
425 * Q1.0.12:: Is there a port of XEmacs to NextStep?
|
|
426 * Q1.0.13:: Is there a port of XEmacs to OS/2?
|
86
|
427 * Q1.0.14:: Where can I get a printed copy of the XEmacs users manual?
|
82
|
428
|
|
429 Policies:
|
|
430 * Q1.1.1:: What is the FAQ editorial policy?
|
|
431 * Q1.1.2:: How do I become a Beta Tester?
|
|
432 * Q1.1.3:: How do I contribute to XEmacs itself?
|
|
433
|
|
434 Credits:
|
|
435 * Q1.2.1:: Who wrote XEmacs?
|
282
|
436 * Q1.2.2:: Who contributed to this version of the FAQ?
|
|
437 * Q1.2.3:: Who contributed to the FAQ in the past?
|
82
|
438
|
|
439 Internationalization:
|
282
|
440 * Q1.3.1:: What is the status of XEmacs v20?
|
82
|
441 * Q1.3.2:: What is the status of Asian-language support, aka @var{mule}?
|
|
442 * Q1.3.3:: How do I type non-ASCII characters?
|
|
443 * Q1.3.4:: Can XEmacs messages come out in a different language?
|
|
444 * Q1.3.5:: Please explain the various input methods in MULE/XEmacs 20.0
|
|
445 * Q1.3.6:: How do I portably code for MULE/XEmacs 20.0?
|
282
|
446 * Q1.3.7:: How about Cyrillic Modes?
|
82
|
447
|
|
448 Getting Started:
|
|
449 * Q1.4.1:: What is a @file{.emacs} and is there a sample one?
|
163
|
450 * Q1.4.2:: Can I use the same @file{.emacs} with the other Emacs?
|
82
|
451 * Q1.4.3:: Any good XEmacs tutorials around?
|
|
452 * Q1.4.4:: May I see an example of a useful XEmacs Lisp function?
|
|
453 * Q1.4.5:: And how do I bind it to a key?
|
|
454 * Q1.4.6:: What's the difference between a macro and a function?
|
126
|
455 * Q1.4.7:: Why options saved with 19.13 don't work with 19.14 or later?
|
0
|
456 @end menu
|
|
457
|
82
|
458 @node Q1.0.1, Q1.0.2, Introduction, Introduction
|
274
|
459 @unnumberedsec 1.0: Introduction
|
|
460 @unnumberedsubsec Q1.0.1: What is XEmacs?
|
|
461
|
0
|
462
|
|
463 An alternative to GNU Emacs, originally based on an early alpha version
|
82
|
464 of FSF's version 19, and has diverged quite a bit since then. XEmacs
|
|
465 was known as Lucid Emacs through version 19.10. Almost all features of
|
227
|
466 GNU Emacs are supported in XEmacs. The maintainers of XEmacs actively
|
82
|
467 track changes to GNU Emacs while also working to add new features.
|
|
468
|
|
469 @node Q1.0.2, Q1.0.3, Q1.0.1, Introduction
|
274
|
470 @unnumberedsubsec Q1.0.2: What is the current version of XEmacs?
|
|
471
|
|
472 XEmacs 20.4 is a minor upgrade from 20.3, containing many bugfixes. It
|
|
473 was released in February 1998.
|
215
|
474
|
|
475 XEmacs 19.16 was the last release of v19, released in November, 1997,
|
|
476 which was also the last version without international language support.
|
82
|
477
|
|
478 @node Q1.0.3, Q1.0.4, Q1.0.2, Introduction
|
274
|
479 @unnumberedsubsec Q1.0.3: Where can I find it?
|
82
|
480
|
|
481 The canonical source and binaries is found via anonymous FTP at:
|
|
482
|
|
483 @example
|
274
|
484 @uref{ftp://ftp.xemacs.org/pub/xemacs/}
|
82
|
485 @end example
|
|
486
|
|
487 @node Q1.0.4, Q1.0.5, Q1.0.3, Introduction
|
274
|
488 @unnumberedsubsec Q1.0.4: Why Another Version of Emacs?
|
82
|
489
|
0
|
490 For a detailed description of the differences between GNU Emacs and
|
|
491 XEmacs and a detailed history of XEmacs, check out the
|
82
|
492 @example
|
274
|
493 @uref{http://www.xemacs.org/NEWS.html, NEWS file}
|
82
|
494 @end example
|
|
495
|
|
496 However, here is a list of some of the reasons why we think you might
|
|
497 consider using it:
|
0
|
498
|
|
499 @itemize @bullet
|
|
500 @item
|
82
|
501 It looks nicer.
|
|
502
|
0
|
503 @item
|
|
504 The XEmacs maintainers are generally more receptive to suggestions than
|
82
|
505 the GNU Emacs maintainers.
|
|
506
|
0
|
507 @item
|
82
|
508 Many more bundled packages than GNU Emacs
|
|
509
|
0
|
510 @item
|
82
|
511 Binaries are available for many common operating systems.
|
|
512
|
0
|
513 @item
|
82
|
514 Face support on TTY's.
|
|
515
|
0
|
516 @item
|
82
|
517 A built-in toolbar.
|
|
518
|
0
|
519 @item
|
82
|
520 Better Motif compliance.
|
|
521
|
0
|
522 @item
|
163
|
523 Some internationalization support (including full MULE support, if
|
|
524 compiled with it.)
|
82
|
525
|
|
526 @item
|
|
527 Variable-width fonts.
|
|
528
|
16
|
529 @item
|
82
|
530 Variable-height lines.
|
|
531
|
0
|
532 @item
|
82
|
533 Marginal annotations.
|
|
534
|
0
|
535 @item
|
82
|
536 ToolTalk support.
|
|
537
|
0
|
538 @item
|
|
539 XEmacs can be used as an Xt widget, and can be embedded within another
|
82
|
540 application.
|
|
541
|
0
|
542 @item
|
82
|
543 Horizontal and vertical scrollbars (using real toolkit scrollbars).
|
|
544
|
0
|
545 @item
|
|
546 Better APIs (and performance) for attaching fonts, colors, and other
|
82
|
547 properties to text.
|
|
548
|
0
|
549 @item
|
82
|
550 The ability to embed arbitrary graphics in a buffer.
|
|
551
|
0
|
552 @item
|
82
|
553 Completely compatible (at the C level) with the Xt-based toolkits.
|
|
554
|
|
555 @item
|
|
556 First production Web Browser supporting Style Sheets.
|
0
|
557 @end itemize
|
|
558
|
82
|
559 @node Q1.0.5, Q1.0.6, Q1.0.4, Introduction
|
274
|
560 @unnumberedsubsec Q1.0.5: Why Haven't XEmacs and GNU Emacs Merged?
|
82
|
561
|
|
562 There are currently irreconcilable differences in the views about
|
|
563 technical, programming, design and organizational matters between RMS
|
|
564 and the XEmacs development team which provide little hope for a merge to
|
|
565 take place in the short-term future.
|
|
566
|
207
|
567 If you have a comment to add regarding the merge, it is a good idea to
|
274
|
568 avoid posting to the newsgroups, because of the very heated flamewars
|
282
|
569 that often result. Mail your questions to @email{xemacs-beta@@xemacs.org} and
|
274
|
570 @email{bug-gnu-emacs@@prep.ai.mit.edu}.
|
207
|
571
|
82
|
572 @node Q1.0.6, Q1.0.7, Q1.0.5, Introduction
|
274
|
573 @unnumberedsubsec Q1.0.6: Where can I get help?
|
0
|
574
|
|
575 Probably the easiest way, if everything is installed, is to use info, by
|
82
|
576 pressing @kbd{C-h i}, or selecting @code{Emacs Info} from the Help Menu.
|
|
577
|
0
|
578 Also, @kbd{M-x apropos} will look for commands for you.
|
|
579
|
|
580 Try reading this FAQ, examining the regular GNU Emacs FAQ (which can be
|
|
581 found with the Emacs 19 distribution) as well as at
|
282
|
582 @uref{http://www.eecs.nwu.edu/emacs/faq/} and reading the Usenet group
|
175
|
583 comp.emacs.xemacs.
|
82
|
584
|
|
585 If that does not help, try posting your question to comp.emacs.xemacs.
|
|
586 Please @strong{do not} post XEmacs related questions to gnu.emacs.help.
|
|
587
|
|
588 If you cannot post or read Usenet news, there is a corresponding mailing
|
|
589 list which is available. It can be subscribed to by sending a message
|
274
|
590 with a subject of @samp{subscribe} to @email{xemacs-request@@xemacs.org}
|
282
|
591 for subscription information and @email{xemacs@@xemacs.org} to send messages
|
175
|
592 to the list.
|
82
|
593
|
|
594 To cancel a subscription, you @strong{must} use the xemacs-request
|
|
595 address. Send a message with a subject of @samp{unsubscribe} to be
|
|
596 removed.
|
|
597
|
|
598 @node Q1.0.7, Q1.0.8, Q1.0.6, Introduction
|
274
|
599 @unnumberedsubsec Q1.0.7: Where is the mailing list archived?
|
82
|
600
|
207
|
601 The mailing list was archived in the directory
|
82
|
602 @example
|
274
|
603 @uref{ftp://ftp.xemacs.org/pub/mlists/}.
|
82
|
604 @end example
|
|
605
|
207
|
606 However, this archive is out of date. The current mailing list server
|
|
607 supports an @code{archive} feature, which may be utilized.
|
|
608
|
82
|
609 @node Q1.0.8, Q1.0.9, Q1.0.7, Introduction
|
274
|
610 @unnumberedsubsec Q1.0.8: How do you pronounce XEmacs?
|
82
|
611
|
|
612 I pronounce it @samp{Eks eemax}.
|
|
613
|
|
614 @node Q1.0.9, Q1.0.10, Q1.0.8, Introduction
|
274
|
615 @unnumberedsubsec Q1.0.9: What does XEmacs look like?
|
82
|
616
|
|
617 Screen snapshots are available in the WWW version of the FAQ.
|
126
|
618 @example
|
274
|
619 @uref{http://www.xemacs.org/faq/xemacs-faq.html}
|
126
|
620 @end example
|
82
|
621
|
|
622 @node Q1.0.10, Q1.0.11, Q1.0.9, Introduction
|
274
|
623 @unnumberedsubsec Q1.0.10: Is there a port of XEmacs to Microsoft ('95 or NT)?
|
|
624
|
|
625 Thanks to efforts of many people, coordinated by
|
|
626 @email{davidh@@wr.com.au, David Hobley} and @email{marcpa@@cam.org, Marc
|
|
627 Paquette}, beta versions of XEmacs now run on 32-bit Windows platforms
|
|
628 (NT and 95). The current betas require having an X server to run
|
|
629 XEmacs; however, a native NT/95 port is in alpha, thanks to
|
|
630 @email{jhar@@tardis.ed.ac.uk, Jonathan Harris}.
|
215
|
631
|
282
|
632 Although some features are still unimplemented, XEmacs 21.0 will support
|
|
633 MS-Windows.
|
|
634
|
215
|
635 The NT development is now coordinated by a mailing list at
|
274
|
636 @email{xemacs-nt@@xemacs.org}.
|
|
637
|
|
638 If you are willing to contribute or want to follow the progress, mail to
|
|
639 @iftex
|
|
640 @*
|
282
|
641 @end iftex
|
274
|
642 @email{xemacs-nt-request@@xemacs.org} to subscribe.
|
215
|
643
|
|
644 Furthermore, Altrasoft is seeking corporate and government sponsors to
|
|
645 help fund a fully native port of XEmacs to Windows 95 and NT using
|
|
646 full-time, senior-level staff working under a professionally managed
|
274
|
647 project structure. See @uref{http://www.altrasoft.com/, the Altrasoft
|
|
648 web site} for more details
|
215
|
649 or contact Altrasoft directly at 1-888-ALTSOFT.
|
|
650
|
|
651
|
|
652 The closest existing port is @dfn{Win-Emacs}, which is based on Lucid
|
274
|
653 Emacs 19.6. Available from @uref{http://www.pearlsoft.com/}.
|
116
|
654
|
82
|
655 There's a port of GNU Emacs (not XEmacs) at
|
|
656 @example
|
274
|
657 @uref{http://www.cs.washington.edu/homes/voelker/ntemacs.html}.
|
82
|
658 @end example
|
|
659
|
|
660 @node Q1.0.11, Q1.0.12, Q1.0.10, Introduction
|
274
|
661 @unnumberedsubsec Q1.0.11: Is there a port of XEmacs to the Macintosh?
|
282
|
662 @c changed
|
82
|
663
|
|
664 There has been a port to the MachTen environment of XEmacs 19.13, but no
|
|
665 patches have been submitted to the maintainers to get this in the
|
|
666 mainstream distribution.
|
|
667
|
282
|
668 For the MacOS, there is a port of
|
|
669 @uref{ftp://ftp.cs.cornell.edu/pub/parmet/, Emacs 18.59}.
|
|
670
|
82
|
671 @node Q1.0.12, Q1.0.13, Q1.0.11, Introduction
|
274
|
672 @unnumberedsubsec Q1.0.12: Is there a port of XEmacs to NextStep?
|
|
673
|
|
674 Carl Edman, apparently no longer at @email{cedman@@princeton.edu}, did
|
|
675 the port of GNU Emacs to NeXTstep and expressed interest in doing the
|
|
676 XEmacs port, but never went any farther.
|
82
|
677
|
86
|
678 @node Q1.0.13, Q1.0.14, Q1.0.12, Introduction
|
274
|
679 @unnumberedsubsec Q1.0.13: Is there a port of XEmacs to OS/2?
|
82
|
680
|
|
681 No, and there is no news of anyone working on it.
|
|
682
|
86
|
683 @node Q1.0.14, Q1.1.1, Q1.0.13, Introduction
|
274
|
684 @unnumberedsubsec Q1.0.14: Where can I obtain a printed copy of the XEmacs users manual?
|
86
|
685
|
213
|
686 Altrasoft Associates, a firm specializing in Emacs-related support and
|
86
|
687 development, will be maintaining the XEmacs user manual. The firm plans
|
207
|
688 to begin publishing printed copies of the manual soon.
|
|
689 @c This used to say `March 1997'!
|
86
|
690
|
|
691 @example
|
274
|
692 Web: @uref{http://www.xemacs.com}
|
|
693 E-mail: @email{info@@xemacs.com}
|
86
|
694 Tel: +1 408 243 3300
|
|
695 @end example
|
|
696
|
88
|
697 @node Q1.1.1, Q1.1.2, Q1.0.14, Introduction
|
274
|
698 @unnumberedsec 1.1: Policies
|
|
699 @unnumberedsubsec Q1.1.1: What is the FAQ editorial policy?
|
82
|
700
|
|
701 The FAQ is actively maintained and modified regularly. All links should
|
|
702 be up to date.
|
|
703
|
|
704 Changes are displayed on a monthly basis. @dfn{Months}, for this
|
|
705 purpose are defined as the 5th of the month through the 5th of the
|
|
706 month. Preexisting questions that have been changed are marked as such.
|
|
707 Brand new questions are tagged.
|
|
708
|
274
|
709 All submissions are welcome. E-mail submissions
|
282
|
710 to
|
|
711 @iftex
|
274
|
712 @*
|
282
|
713 @end iftex
|
|
714 @email{faq@@xemacs.org, Christian Nyb@o{}}.
|
82
|
715
|
|
716 Please make sure that @samp{XEmacs FAQ} appears on the Subject: line.
|
|
717 If you think you have a better way of answering a question, or think a
|
|
718 question should be included, I'd like to hear about it. Questions and
|
|
719 answers included into the FAQ will be edited for spelling and grammar,
|
|
720 and will be attributed. Answers appearing without attribution are
|
|
721 either from versions of the FAQ dated before May 1996, or are from one
|
|
722 of the four people listed at the top of this document. Answers quoted
|
|
723 from Usenet news articles will always be attributed, regardless of the
|
|
724 author.
|
|
725
|
|
726 @node Q1.1.2, Q1.1.3, Q1.1.1, Introduction
|
274
|
727 @unnumberedsubsec Q1.1.2: How do I become a Beta Tester?
|
|
728
|
|
729 Send an email message to @email{xemacs-beta-request@@xemacs.org} with a
|
282
|
730 subject line of @samp{subscribe}.
|
82
|
731
|
|
732 Be prepared to get your hands dirty, as beta testers are expected to
|
|
733 identify problems as best they can.
|
|
734
|
|
735 @node Q1.1.3, Q1.2.1, Q1.1.2, Introduction
|
274
|
736 @unnumberedsubsec Q1.1.3: How do I contribute to XEmacs itself?
|
|
737
|
|
738 Ben Wing @email{ben@@666.com} writes:
|
82
|
739
|
|
740 @quotation
|
|
741 BTW if you have a wish list of things that you want added, you have to
|
|
742 speak up about it! More specifically, you can do the following if you
|
|
743 want a feature added (in increasing order of usefulness):
|
|
744
|
|
745 @itemize @bullet
|
|
746 @item
|
|
747 Make a posting about a feature you want added.
|
|
748
|
|
749 @item
|
|
750 Become a beta tester and make more postings about those same features.
|
|
751
|
|
752 @item
|
|
753 Convince us that you're going to use the features in some cool and
|
|
754 useful way.
|
|
755
|
|
756 @item
|
|
757 Come up with a clear and well-thought-out API concerning the features.
|
|
758
|
|
759 @item
|
|
760 Write the code to implement a feature and send us a patch.
|
|
761 @end itemize
|
|
762
|
|
763 (not that we're necessarily requiring you to write the code, but we can
|
|
764 always hope :)
|
|
765 @end quotation
|
|
766
|
|
767 @node Q1.2.1, Q1.2.2, Q1.1.3, Introduction
|
274
|
768 @unnumberedsec 1.2: Credits
|
|
769 @unnumberedsubsec Q1.2.1: Who wrote XEmacs?
|
82
|
770
|
|
771 XEmacs is the result of the time and effort of many people. The
|
213
|
772 developers responsible for the 19.16/20.x releases are:
|
82
|
773
|
|
774 @itemize @bullet
|
282
|
775 @item @email{martin@@xemacs.org, Martin Buchholz}
|
274
|
776 @ifhtml
|
282
|
777 <br><img src="mrb.jpeg" alt="Portrait of Martin Buchholz"><br>
|
274
|
778 @end ifhtml
|
|
779
|
|
780
|
|
781 @item @email{steve@@altair.xemacs.org, Steve Baur}
|
|
782
|
|
783 @ifhtml
|
282
|
784 <br><img src="steve.gif" alt="Portrait of Steve Baur"><br>
|
274
|
785 @end ifhtml
|
|
786
|
|
787
|
|
788 @item @email{hniksic@@srce.hr, Hrvoje Niksic}
|
|
789
|
|
790 @ifhtml
|
282
|
791 <br><img src="hniksic.jpeg" alt="Portrait of Hrvoje Niksic"><br>
|
274
|
792 @end ifhtml
|
|
793
|
82
|
794 @end itemize
|
|
795
|
|
796 The developers responsible for the 19.14 release are:
|
|
797
|
|
798 @itemize @bullet
|
274
|
799 @item @email{cthomp@@xemacs.org, Chuck Thompson}
|
|
800 @ifhtml
|
282
|
801 <br><img src="cthomp.jpeg" alt="Portrait of Chuck Thompson"><br>
|
274
|
802 @end ifhtml
|
82
|
803
|
|
804 Chuck was Mr. XEmacs from 19.11 through 19.14, and is responsible
|
|
805 for XEmacs becoming a widely distributed program over the Internet.
|
|
806
|
274
|
807 @item @email{ben@@666.com, Ben Wing}
|
|
808 @ifhtml
|
282
|
809 <br><img src="wing.gif" alt="Portrait of Ben Wing"><br>
|
274
|
810 @end ifhtml
|
|
811
|
82
|
812 @end itemize
|
|
813
|
282
|
814
|
|
815 @itemize @bullet
|
|
816 @item @email{jwz@@netscape.com, Jamie Zawinski}
|
|
817 @ifhtml
|
|
818 <br><img src="jwz.gif" alt="Portrait of Jamie Zawinski"><br>
|
|
819 @end ifhtml
|
|
820
|
82
|
821 Jamie Zawinski was Mr. Lucid Emacs from 19.0 through 19.10, the last
|
|
822 release actually named Lucid Emacs. Richard Mlynarik was crucial to
|
|
823 most of those releases.
|
|
824
|
274
|
825 @item @email{mly@@adoc.xerox.com, Richard Mlynarik}
|
82
|
826 @end itemize
|
|
827
|
|
828 Along with many other contributors, partially enumerated in the
|
|
829 @samp{About XEmacs} option in the Help menu.
|
|
830
|
|
831 @node Q1.2.2, Q1.2.3, Q1.2.1, Introduction
|
274
|
832 @unnumberedsubsec Q1.2.2: Who contributed to this version of the FAQ?
|
82
|
833
|
|
834 The following people contributed valuable suggestions to building this
|
|
835 version of the FAQ (listed in alphabetical order):
|
|
836
|
|
837 @itemize @bullet
|
274
|
838 @item @email{steve@@xemacs.org, SL Baur}
|
|
839
|
|
840 @item @email{hniksic@@srce.hr, Hrvoje Niksic}
|
|
841
|
|
842 @item @email{Aki.Vehtari@@hut.fi, Aki Vehtari}
|
227
|
843
|
82
|
844 @end itemize
|
|
845
|
|
846 @node Q1.2.3, Q1.3.1, Q1.2.2, Introduction
|
274
|
847 @unnumberedsubsec Q1.2.3: Who contributed to the FAQ in the past?
|
82
|
848
|
|
849 This is only a partial list, as many names were lost in a hard disk
|
|
850 crash some time ago.
|
|
851
|
|
852 @itemize @bullet
|
274
|
853 @item @email{binge@@aloft.att.com, Curtis.N.Bingham}
|
|
854
|
|
855 @item @email{rjc@@cogsci.ed.ac.uk, Richard Caley}
|
|
856
|
|
857 @item @email{cognot@@ensg.u-nancy.fr, Richard Cognot}
|
|
858
|
|
859 @item @email{wgd@@martigny.ai.mit.edu, William G. Dubuque}
|
|
860
|
|
861 @item @email{eeide@@cs.utah.edu, Eric Eide}
|
|
862
|
|
863 @item @email{cflatter@@nrao.edu, Chris Flatters}
|
|
864
|
|
865 @item @email{ginsparg@@adra.com, Evelyn Ginsparg}
|
|
866
|
|
867 @item @email{hall@@aplcenmp.apl.jhu.edu, Marty Hall}
|
|
868
|
|
869 @item @email{dkindred@@cmu.edu, Darrell Kindred}
|
|
870
|
|
871 @item @email{dmoore@@ucsd.edu, David Moore}
|
|
872
|
|
873 @item @email{arup+@@cmu.edu, Arup Mukherjee}
|
|
874
|
|
875 @item @email{nickel@@prz.tu-berlin.de, Juergen Nickelsen}
|
|
876
|
|
877 @item @email{powell@@csl.ncsa.uiuc.edu, Kevin R. Powell}
|
|
878
|
|
879 @item @email{dworkin@@ccs.neu.edu, Justin Sheehy}
|
|
880
|
|
881 @item @email{stig@@hackvan.com, Stig}
|
|
882
|
|
883 @item @email{Aki.Vehtari@@hut.fi, Aki Vehtari}
|
82
|
884 @end itemize
|
|
885
|
|
886 @node Q1.3.1, Q1.3.2, Q1.2.3, Introduction
|
274
|
887 @unnumberedsec 1.3: Internationalization
|
|
888 @unnumberedsubsec Q1.3.1: What is the status of XEmacs v20?
|
82
|
889
|
|
890 XEmacs v20 is the version of XEmacs that includes MULE (Asian-language)
|
163
|
891 support. XEmacs 20.0 was released in February 1997, followed by XEmacs
|
274
|
892 20.2 in May, XEmacs 20.3 in November and XEmacs 20.4 in February 1998. When compiled without MULE
|
|
893 support, 20.4 is approximately as stable as 19.16, and probably faster
|
215
|
894 (due to additional optimization work.)
|
|
895
|
|
896 As of XEmacs 20.3, version 20 is @emph{the} supported version of
|
|
897 XEmacs. This means that 19.16 will optionally receive stability fixes
|
282
|
898 (if any), but that all the real development work will be done on the v20
|
215
|
899 tree.
|
|
900
|
|
901 The incompatible changes in XEmacs 20 include the additional byte-codes,
|
|
902 new primitive data types (@code{character}, @code{char-table}, and
|
|
903 @code{range-table}). This means that the character-integer equivalence
|
|
904 inherent to all the previous Emacs and XEmacs releases no longer
|
|
905 applies.
|
|
906
|
|
907 However, to avoid breaking old code, many functions that should normally
|
|
908 accept characters work with integers, and vice versa. For more
|
282
|
909 information, see the Lisp reference manual. Here is a relevant excerpt,
|
215
|
910 for your convenience.
|
|
911
|
|
912 @quotation
|
|
913 In XEmacs version 19, and in all versions of FSF GNU Emacs, a
|
|
914 @dfn{character} in XEmacs Lisp is nothing more than an integer.
|
|
915 This is yet another holdover from XEmacs Lisp's derivation from
|
|
916 vintage-1980 Lisps; modern versions of Lisp consider this equivalence
|
|
917 a bad idea, and have separate character types. In XEmacs version 20,
|
|
918 the modern convention is followed, and characters are their own
|
|
919 primitive types. (This change was necessary in order for @sc{MULE},
|
|
920 i.e. Asian-language, support to be correctly implemented.)
|
|
921
|
|
922 Even in XEmacs version 20, remnants of the equivalence between
|
|
923 characters and integers still exist; this is termed the @dfn{char-int
|
|
924 confoundance disease}. In particular, many functions such as @code{eq},
|
|
925 @code{equal}, and @code{memq} have equivalent functions (@code{old-eq},
|
|
926 @code{old-equal}, @code{old-memq}, etc.) that pretend like characters
|
|
927 are integers are the same. Byte code compiled under any version 19
|
|
928 Emacs will have all such functions mapped to their @code{old-} equivalents
|
|
929 when the byte code is read into XEmacs 20. This is to preserve
|
|
930 compatibility -- Emacs 19 converts all constant characters to the equivalent
|
|
931 integer during byte-compilation, and thus there is no other way to preserve
|
|
932 byte-code compatibility even if the code has specifically been written
|
|
933 with the distinction between characters and integers in mind.
|
|
934
|
|
935 Every character has an equivalent integer, called the @dfn{character
|
|
936 code}. For example, the character @kbd{A} is represented as the
|
|
937 @w{integer 65}, following the standard @sc{ASCII} representation of
|
|
938 characters. If XEmacs was not compiled with @sc{MULE} support, the
|
|
939 range of this integer will always be 0 to 255 -- eight bits, or one
|
|
940 byte. (Integers outside this range are accepted but silently truncated;
|
|
941 however, you should most decidedly @emph{not} rely on this, because it
|
|
942 will not work under XEmacs with @sc{MULE} support.) When @sc{MULE}
|
|
943 support is present, the range of character codes is much
|
|
944 larger. (Currently, 19 bits are used.)
|
|
945
|
|
946 FSF GNU Emacs uses kludgy character codes above 255 to represent
|
|
947 keyboard input of @sc{ASCII} characters in combination with certain
|
|
948 modifiers. XEmacs does not use this (a more general mechanism is
|
|
949 used that does not distinguish between @sc{ASCII} keys and other
|
|
950 keys), so you will never find character codes above 255 in a
|
|
951 non-@sc{MULE} XEmacs.
|
|
952
|
|
953 Individual characters are not often used in programs. It is far more
|
|
954 common to work with @emph{strings}, which are sequences composed of
|
217
|
955 characters.
|
215
|
956 @end quotation
|
82
|
957
|
|
958 @node Q1.3.2, Q1.3.3, Q1.3.1, Introduction
|
274
|
959 @unnumberedsubsec Q1.3.2: What is the status of Asian-language support, aka MULE?
|
82
|
960
|
|
961 The MULE support works OK but still needs a fair amount of work before
|
|
962 it's really solid. We could definitely use some help here, esp. people
|
|
963 who speak Japanese and will use XEmacs/MULE to work with Japanese and
|
207
|
964 have some experience with E-Lisp.
|
|
965
|
282
|
966 As the fundings on Mule have stopped, the Mule part of XEmacs is currently
|
207
|
967 looking for a full-time maintainer. If you can provide help here, or
|
274
|
968 are willing to fund the work, please mail to @email{xemacs-beta@@xemacs.org}.
|
207
|
969
|
|
970 @xref{Q1.1.2}.
|
82
|
971
|
|
972 @node Q1.3.3, Q1.3.4, Q1.3.2, Introduction
|
274
|
973 @unnumberedsubsec Q1.3.3: How do I type non-ASCII characters?
|
82
|
974
|
|
975 See question 3.5.7 (@xref{Q3.5.7}) in part 3 of this FAQ.
|
|
976
|
|
977 @node Q1.3.4, Q1.3.5, Q1.3.3, Introduction
|
274
|
978 @unnumberedsubsec Q1.3.4: Can XEmacs messages come out in a different language?
|
82
|
979
|
|
980 The message-catalog support has mostly been written but doesn't
|
|
981 currently work. The first release of XEmacs 20 will @emph{not} support
|
|
982 it. However, menubar localization @emph{does} work, even in 19.14. To
|
|
983 enable it, add to your @file{Emacs} file entries like this:
|
|
984
|
|
985 @example
|
|
986 Emacs*XlwMenu.resourceLabels: True
|
|
987 Emacs*XlwMenu.file.labelString: Fichier
|
|
988 Emacs*XlwMenu.openInOtherWindow.labelString: In anderem Fenster offnen
|
|
989 @end example
|
|
990
|
|
991 The name of the resource is derived from the non-localized entry by
|
272
|
992 removing punctuation and capitalizing as above.
|
82
|
993
|
|
994 @node Q1.3.5, Q1.3.6, Q1.3.4, Introduction
|
274
|
995 @unnumberedsubsec Q1.3.5: Please explain the various input methods in MULE/XEmacs 20.0
|
|
996
|
|
997 @email{morioka@@jaist.ac.jp, MORIOKA Tomohiko} writes:
|
82
|
998
|
|
999 @quotation
|
282
|
1000 Original Mule supports the following input methods: Wnn4, Wnn6, Canna, SJ3
|
82
|
1001 and XIM. Interfaces for Wnn and SJ3 uses the @code{egg} user
|
|
1002 interface. Interface for Canna does not use @samp{egg}. I don't know
|
|
1003 about XIM. It is to support ATOK, of course, it may work for another
|
|
1004 servers.
|
|
1005
|
|
1006 Wnn supports Japanese, Chinese and Korean. It is made by OMRON and Kyôto
|
|
1007 university. It is a powerful and complex system. Wnn4 is free and Wnn6
|
|
1008 is not free.
|
|
1009
|
|
1010 Canna supports only Japanese. It is made by NEC. It is a simple and
|
|
1011 powerful system. Canna uses only grammar (Wnn uses grammar and
|
|
1012 probability between words), so I think Wnn is cleverer than Canna,
|
|
1013 however Canna users made a good grammar and dictionary. So for standard
|
|
1014 modern Japanese, Canna seems cleverer than Wnn4. In addition, the UNIX
|
|
1015 version of Canna is free (now there is a Microsoft Windows version).
|
|
1016
|
|
1017 SJ3 supports only Japanese. It is made by Sony. XIM supports was made
|
|
1018 to use ATOK (a major input method in personal computer world). XIM is
|
|
1019 the standard for accessing input methods bundled in Japanese versions of
|
|
1020 Solaris. (XEmacs 20 will support XIM input).
|
|
1021
|
|
1022 Egg consists of following parts:
|
|
1023
|
|
1024 @enumerate
|
290
|
1025 @item
|
|
1026 Input character Translation System (ITS) layer.
|
82
|
1027 It translates ASCII inputs to Kana/PinYin/Hangul characters.
|
|
1028
|
290
|
1029 @item
|
|
1030 Kana/PinYin/Hangul to Kanji transfer layer.
|
126
|
1031 It is interface layer for network Kana-Kanji server (Wnn and Sj3).
|
82
|
1032 @end enumerate
|
|
1033
|
|
1034 These input methods are modal, namely there are mode, alphabet mode and
|
|
1035 Kana-Kanji transfer mode. However there are mode-less input methods for
|
|
1036 Egg and Canna. @samp{Boiled-egg} is a mode-less input method running on
|
|
1037 Egg. For Canna, @samp{canna.el} has a tiny boiled-egg like command,
|
|
1038 @code{(canna-boil)}, and there are some boiled-egg like utilities. In
|
|
1039 addition, it was planned to make an abstraction for all transfer type
|
|
1040 input methods. However authors of input methods are busy, so maybe this
|
|
1041 plan is stopped. Perhaps after Mule merged GNU Emacs will be released,
|
|
1042 it will be continued.
|
|
1043 @end quotation
|
|
1044
|
|
1045 @node Q1.3.6, Q1.3.7, Q1.3.5, Introduction
|
274
|
1046 @unnumberedsubsec Q1.3.6: How do I portably code for MULE/XEmacs 20?
|
|
1047
|
|
1048 @email{morioka@@jaist.ac.jp, MORIOKA Tomohiko} writes:
|
82
|
1049
|
|
1050 @quotation
|
|
1051 MULE and XEmacs are quite different. So the application
|
|
1052 implementor must write separate code for these mule variants.
|
|
1053
|
|
1054 MULE and the next version of Emacs are similar but the symbols are very
|
|
1055 different---requiring separate code as well.
|
|
1056
|
|
1057 Namely we must support 3 kinds of mule variants and 4 or 5 or 6 kinds of
|
|
1058 emacs variants... (;_;) I'm shocked, so I wrote a wrapper package called
|
|
1059 @code{emu} to provide a common interface.
|
|
1060
|
|
1061 I have the following suggestions about dealing with mule variants:
|
|
1062
|
|
1063 @itemize @bullet
|
|
1064 @item
|
|
1065 @code{(featurep 'mule)} @code{t} on all mule variants
|
|
1066
|
|
1067 @item
|
|
1068 @code{(boundp 'MULE)} is @code{t} on only MULE. Maybe the next version
|
|
1069 of Emacs will not have this symbol.
|
|
1070
|
|
1071 @item
|
|
1072 MULE has a variable @code{mule-version}. Perhaps the next version of
|
|
1073 Emacs will have this variable as well.
|
|
1074 @end itemize
|
|
1075
|
|
1076 Following is a sample to distinguish mule variants:
|
|
1077
|
|
1078 @lisp
|
|
1079 (if (featurep 'mule)
|
|
1080 (cond ((boundp 'MULE)
|
|
1081 ;; for original Mule
|
|
1082 )
|
|
1083 ((string-match "XEmacs" emacs-version)
|
|
1084 ;; for XEmacs with Mule
|
|
1085 )
|
|
1086 (t
|
|
1087 ;; for next version of Emacs
|
|
1088 ))
|
|
1089 ;; for old emacs variants
|
|
1090 )
|
|
1091 @end lisp
|
|
1092 @end quotation
|
|
1093
|
|
1094 @node Q1.3.7, Q1.4.1, Q1.3.6, Introduction
|
274
|
1095 @unnumberedsubsec Q1.3.7: How about Cyrillic Modes?
|
|
1096
|
|
1097 @email{ilya@@math.ohio-state.edu, Ilya Zakharevich} writes:
|
82
|
1098
|
|
1099 @quotation
|
|
1100 There is a cyrillic mode in the file @file{mysetup.zip} in
|
274
|
1101 @iftex
|
|
1102 @*
|
282
|
1103 @end iftex
|
274
|
1104 @uref{ftp://ftp.math.ohio-state.edu/pub/users/ilya/emacs/}. This is a
|
|
1105 modification to @email{ava@@math.jhu.ed, Valery Alexeev's} @file{russian.el}
|
282
|
1106 which can be obtained from
|
82
|
1107 @end quotation
|
|
1108
|
282
|
1109 @uref{http://ftpsearch.ntnu.no/?query=russian.el.Z}.
|
|
1110 @c dead link above
|
|
1111
|
274
|
1112 @email{d.barsky@@ee.surrey.ac.uk, Dima Barsky} writes:
|
82
|
1113
|
|
1114 @quotation
|
274
|
1115 There is another cyrillic mode for both GNU Emacs and XEmacs by
|
|
1116 @email{manin@@camelot.mssm.edu, Dmitrii
|
282
|
1117 (Mitya) Manin} at
|
274
|
1118 @iftex
|
|
1119
|
282
|
1120 @end iftex
|
|
1121 @uref{http://kulichki-lat.rambler.ru/centrolit/manin/cyr.el}.
|
|
1122 @c Link above, <URL:http://camelot.mssm.edu/~manin/cyr.el> was dead.
|
|
1123 @c Changed to russian host instead
|
82
|
1124 @end quotation
|
|
1125
|
274
|
1126 @email{rebecca.ore@@op.net, Rebecca Ore} writes:
|
203
|
1127
|
|
1128 @quotation
|
|
1129 The fullest resource I found on Russian language use (in and out of
|
274
|
1130 XEmacs) is @uref{http://sunsite.oit.unc.edu/sergei/Software/Software.html}
|
203
|
1131 @end quotation
|
|
1132
|
82
|
1133 @node Q1.4.1, Q1.4.2, Q1.3.7, Introduction
|
274
|
1134 @unnumberedsec 1.4: Getting Started, Backing up & Recovery
|
|
1135 @unnumberedsubsec Q1.4.1: What is a @file{.emacs} and is there a sample one?
|
82
|
1136
|
|
1137 The @file{.emacs} file is used to customize XEmacs to your tastes. No
|
|
1138 two are alike, nor are they expected to be alike, but that's the point.
|
|
1139 The XEmacs distribution contains an excellent starter example in the etc
|
|
1140 directory called @file{sample.emacs}. Copy this file from there to your
|
|
1141 home directory and rename it @file{.emacs}. Then edit it to suit.
|
|
1142
|
|
1143 Starting with 19.14, you may bring the @file{sample.emacs} into an
|
|
1144 XEmacs buffer by selecting @samp{Help->Sample .emacs} from the menubar.
|
|
1145 To determine the location of the @file{etc} directory type the command
|
282
|
1146 @kbd{C-h v data-directory @key{RET}}.
|
82
|
1147
|
|
1148 @node Q1.4.2, Q1.4.3, Q1.4.1, Introduction
|
274
|
1149 @unnumberedsubsec Q1.4.2: Can I use the same @file{.emacs} with the other Emacs?
|
82
|
1150
|
|
1151 Yes. The sample @file{.emacs} included in the XEmacs distribution will
|
|
1152 show you how to handle different versions and flavors of Emacs.
|
|
1153
|
|
1154 @node Q1.4.3, Q1.4.4, Q1.4.2, Introduction
|
274
|
1155 @unnumberedsubsec Q1.4.3: Any good tutorials around?
|
82
|
1156
|
|
1157 There's the XEmacs tutorial available from the Help Menu, or by typing
|
274
|
1158 @kbd{C-h t}. To check whether it's available in a non-english language,
|
|
1159 type @kbd{C-u C-h t TAB}, type the first letters of your preferred
|
282
|
1160 language, then type @key{RET}.
|
82
|
1161
|
|
1162 There's an Emacs Lisp tutorial at
|
|
1163
|
|
1164 @example
|
274
|
1165 @uref{ftp://prep.ai.mit.edu/pub/gnu/emacs-lisp-intro-1.04.tar.gz}.
|
82
|
1166 @end example
|
|
1167
|
274
|
1168 @email{erik@@petaxp.rug.ac.be, Erik Sundermann} has made a tutorial web
|
282
|
1169 page at
|
274
|
1170 @iftex
|
|
1171 @*
|
282
|
1172 @end iftex
|
274
|
1173 @uref{http://petaxp.rug.ac.be/~erik/xemacs/}.
|
82
|
1174
|
|
1175 @node Q1.4.4, Q1.4.5, Q1.4.3, Introduction
|
274
|
1176 @unnumberedsubsec Q1.4.4: May I see an example of a useful XEmacs Lisp function?
|
82
|
1177
|
|
1178 The following function does a little bit of everything useful. It does
|
|
1179 something with the prefix argument, it examines the text around the
|
|
1180 cursor, and it's interactive so it may be bound to a key. It inserts
|
|
1181 copies of the current word the cursor is sitting on at the cursor. If
|
|
1182 you give it a prefix argument: @kbd{C-u 3 M-x double-word} then it will
|
|
1183 insert 3 copies.
|
|
1184
|
|
1185 @lisp
|
|
1186 (defun double-word (count)
|
|
1187 "Insert a copy of the current word underneath the cursor"
|
|
1188 (interactive "*p")
|
|
1189 (let (here there string)
|
|
1190 (save-excursion
|
|
1191 (forward-word -1)
|
|
1192 (setq here (point))
|
|
1193 (forward-word 1)
|
|
1194 (setq there (point))
|
|
1195 (setq string (buffer-substring here there)))
|
|
1196 (while (>= count 1)
|
163
|
1197 (insert string)
|
|
1198 (decf count))))
|
82
|
1199 @end lisp
|
|
1200
|
|
1201 The best way to see what is going on here is to let XEmacs tell you.
|
|
1202 Put the code into an XEmacs buffer, and do a @kbd{C-h f} with the cursor
|
|
1203 sitting just to the right of the function you want explained. Eg. move
|
|
1204 the cursor to the SPACE between @code{interactive} and @samp{"*p"} and
|
|
1205 hit @kbd{C-h f} to see what the function @code{interactive} does. Doing
|
|
1206 this will tell you that the @code{*} requires a writable buffer, and
|
|
1207 @code{p} converts the prefix argument to a number, and
|
|
1208 @code{interactive} allows you to execute the command with @kbd{M-x}.
|
|
1209
|
|
1210 @node Q1.4.5, Q1.4.6, Q1.4.4, Introduction
|
274
|
1211 @unnumberedsubsec Q1.4.5: And how do I bind it to a key?
|
82
|
1212
|
|
1213 To bind to a key do:
|
|
1214
|
|
1215 @lisp
|
|
1216 (global-set-key "\C-cd" 'double-word)
|
|
1217 @end lisp
|
|
1218
|
|
1219 Or interactively, @kbd{M-x global-set-key} and follow the prompts.
|
|
1220
|
|
1221 @node Q1.4.6, Q1.4.7, Q1.4.5, Introduction
|
274
|
1222 @unnumberedsubsec Q1.4.6: What's the difference between a macro and a function?
|
82
|
1223
|
163
|
1224 Quoting from the Lisp Reference (a.k.a @dfn{Lispref}) Manual:
|
82
|
1225
|
|
1226 @dfn{Macros} enable you to define new control constructs and other
|
|
1227 language features. A macro is defined much like a function, but instead
|
|
1228 of telling how to compute a value, it tells how to compute another Lisp
|
|
1229 expression which will in turn compute the value. We call this
|
|
1230 expression the @dfn{expansion} of the macro.
|
|
1231
|
|
1232 Macros can do this because they operate on the unevaluated expressions
|
|
1233 for the arguments, not on the argument values as functions do. They can
|
|
1234 therefore construct an expansion containing these argument expressions
|
|
1235 or parts of them.
|
|
1236
|
163
|
1237 Do not confuse the two terms with @dfn{keyboard macros}, which are
|
|
1238 another matter, entirely. A keyboard macro is a key bound to several
|
|
1239 other keys. Refer to manual for details.
|
|
1240
|
213
|
1241 @node Q1.4.7, , Q1.4.6, Introduction
|
274
|
1242 @unnumberedsubsec Q1.4.7: How come options saved with 19.13 don't work with 19.14 or later?
|
82
|
1243
|
|
1244 There's a problem with options of the form:
|
|
1245
|
|
1246 @lisp
|
|
1247 (add-spec-list-to-specifier (face-property 'searchm-field 'font)
|
|
1248 '((global (nil))))
|
|
1249 @end lisp
|
|
1250
|
|
1251 saved by a 19.13 XEmacs that causes a 19.14 XEmacs grief. You must
|
126
|
1252 delete these options. XEmacs 19.14 and later no longer write the
|
|
1253 options directly to @file{.emacs} which should allow us to deal with
|
|
1254 version incompatibilities better in the future.
|
82
|
1255
|
|
1256 Options saved under XEmacs 19.13 are protected by code that specifically
|
|
1257 requires a version 19 XEmacs. This won't be a problem unless you're
|
227
|
1258 using XEmacs v20. You should consider changing the code to read:
|
82
|
1259
|
|
1260 @lisp
|
|
1261 (cond
|
|
1262 ((and (string-match "XEmacs" emacs-version)
|
|
1263 (boundp 'emacs-major-version)
|
|
1264 (or (and (= emacs-major-version 19)
|
|
1265 (>= emacs-minor-version 12))
|
|
1266 (>= emacs-major-version 20)))
|
274
|
1267 ...
|
|
1268 ))
|
82
|
1269 @end lisp
|
|
1270
|
|
1271 @node Installation, Customization, Introduction, Top
|
274
|
1272 @unnumbered 2 Installation and Trouble Shooting
|
82
|
1273
|
|
1274 This is part 2 of the XEmacs Frequently Asked Questions list. This
|
|
1275 section is devoted to Installation, Maintenance and Trouble Shooting.
|
|
1276
|
|
1277 @menu
|
|
1278 Installation:
|
282
|
1279 * Q2.0.1:: Running XEmacs without installing.
|
|
1280 * Q2.0.2:: XEmacs is too big.
|
82
|
1281 * Q2.0.3:: Compiling XEmacs with Netaudio.
|
163
|
1282 * Q2.0.4:: Problems with Linux and ncurses.
|
82
|
1283 * Q2.0.5:: Do I need X11 to run XEmacs?
|
|
1284 * Q2.0.6:: I'm having strange crashes. What do I do?
|
|
1285 * Q2.0.7:: Libraries in non-standard locations.
|
|
1286 * Q2.0.8:: can't resolve symbol _h_errno
|
282
|
1287 * Q2.0.9:: Where do I find external libraries?
|
82
|
1288 * Q2.0.10:: After I run configure I find a coredump, is something wrong?
|
|
1289 * Q2.0.11:: XEmacs can't resolve host names.
|
282
|
1290 * Q2.0.12:: Why can't I strip XEmacs?
|
82
|
1291 * Q2.0.13:: Can't link XEmacs on Solaris with Gcc.
|
282
|
1292 * Q2.0.14:: Make on HP/UX 9 fails after linking temacs
|
82
|
1293
|
|
1294 Trouble Shooting:
|
|
1295 * Q2.1.1:: XEmacs just crashed on me!
|
|
1296 * Q2.1.2:: Cryptic Minibuffer messages.
|
163
|
1297 * Q2.1.3:: Translation Table Syntax messages at Startup.
|
82
|
1298 * Q2.1.4:: Startup warnings about deducing proper fonts?
|
|
1299 * Q2.1.5:: XEmacs cannot connect to my X Terminal.
|
|
1300 * Q2.1.6:: XEmacs just locked up my Linux X server.
|
|
1301 * Q2.1.7:: HP Alt key as Meta.
|
|
1302 * Q2.1.8:: got (wrong-type-argument color-instance-p nil)!
|
|
1303 * Q2.1.9:: XEmacs causes my OpenWindows 3.0 server to crash.
|
|
1304 * Q2.1.10:: Warnings from incorrect key modifiers.
|
282
|
1305 * Q2.1.11:: Can't instantiate image error... in toolbar
|
82
|
1306 * Q2.1.12:: Regular Expression Problems on DEC OSF1.
|
|
1307 * Q2.1.13:: HP/UX 10.10 and @code{create_process} failure
|
|
1308 * Q2.1.14:: @kbd{C-g} doesn't work for me. Is it broken?
|
|
1309 * Q2.1.15:: How to debug an XEmacs problem with a debugger.
|
|
1310 * Q2.1.16:: XEmacs crashes in @code{strcat} on HP/UX 10.
|
|
1311 * Q2.1.17:: @samp{Marker does not point anywhere}.
|
|
1312 * Q2.1.18:: 19.14 hangs on HP/UX 10.10.
|
|
1313 * Q2.1.19:: XEmacs does not follow the local timezone.
|
|
1314 * Q2.1.20:: @samp{Symbol's function definition is void: hkey-help-show.}
|
|
1315 * Q2.1.21:: Every so often the XEmacs frame freezes.
|
116
|
1316 * Q2.1.22:: XEmacs seems to take a really long time to do some things.
|
163
|
1317 * Q2.1.23:: Movemail on Linux does not work for XEmacs 19.15 and later.
|
82
|
1318 @end menu
|
|
1319
|
|
1320 @node Q2.0.1, Q2.0.2, Installation, Installation
|
274
|
1321 @unnumberedsec 2.0: Installation
|
|
1322 @unnumberedsubsec Q2.0.1: Running XEmacs without installing
|
82
|
1323 The @file{INSTALL} file says that up to 108 MB of space is needed
|
|
1324 temporarily during installation! How can I just try it out?
|
|
1325
|
|
1326 XEmacs will run in place without requiring installation and copying of
|
|
1327 the Lisp directories, and without having to specify a special build-time
|
|
1328 flag. It's the copying of the Lisp directories that requires so much
|
|
1329 space. XEmacs is largely written in Lisp.
|
|
1330
|
|
1331 A good method is to make a shell alias for xemacs:
|
|
1332
|
|
1333 @example
|
163
|
1334 alias xemacs=/i/xemacs-20.2/src/xemacs
|
82
|
1335 @end example
|
|
1336
|
|
1337 (You will obviously use whatever directory you downloaded the source
|
163
|
1338 tree to instead of @file{/i/xemacs-20.2}).
|
82
|
1339
|
|
1340 This will let you run XEmacs without massive copying.
|
|
1341
|
|
1342 @node Q2.0.2, Q2.0.3, Q2.0.1, Installation
|
274
|
1343 @unnumberedsubsec Q2.0.2: XEmacs is too big
|
82
|
1344
|
207
|
1345 Although this entry has been written for XEmacs 19.13, most of it still
|
|
1346 stands true.
|
|
1347
|
274
|
1348 @email{steve@@altair.xemacs.org, Steve Baur} writes:
|
82
|
1349
|
|
1350 @quotation
|
175
|
1351 The 45MB of space required by the installation directories can be
|
|
1352 reduced dramatically if desired. Gzip all the .el files. Remove all
|
|
1353 the packages you'll never want to use (or even ones you do like the two
|
|
1354 obsolete mailcrypts and Gnus 4 in 19.13). Remove the TexInfo manuals.
|
|
1355 Remove the Info (and use just hardcopy versions of the manual). Remove
|
|
1356 most of the stuff in etc. Remove or gzip all the source code. Gzip or
|
|
1357 remove the C source code. Configure it so that copies are not made of
|
|
1358 the support lisp. I'm not advocating any of these things, just pointing
|
|
1359 out ways to reduce the disk requirements if desired.
|
|
1360
|
|
1361 Now examine the space used by directory:
|
|
1362
|
282
|
1363 @format
|
175
|
1364 0 /usr/local/bin/xemacs
|
|
1365 2048 /usr/local/bin/xemacs-19.13
|
|
1366
|
|
1367 1546 /usr/local/lib/xemacs-19.13/i486-miranova-sco3.2v4.2
|
|
1368 1158 /usr/local/lib/xemacs-19.13/i486-unknown-linux1.2.13
|
282
|
1369 @end format
|
175
|
1370
|
|
1371 You need to keep these. XEmacs isn't stripped by default in
|
|
1372 installation, you should consider stripping. That will save you about
|
|
1373 5MB right there.
|
|
1374
|
282
|
1375 @format
|
175
|
1376 207 /usr/local/lib/xemacs-19.13/etc/w3
|
|
1377 122 /usr/local/lib/xemacs-19.13/etc/sounds
|
|
1378 18 /usr/local/lib/xemacs-19.13/etc/sparcworks
|
|
1379 159 /usr/local/lib/xemacs-19.13/etc/vm
|
|
1380 6 /usr/local/lib/xemacs-19.13/etc/e
|
|
1381 21 /usr/local/lib/xemacs-19.13/etc/eos
|
|
1382 172 /usr/local/lib/xemacs-19.13/etc/toolbar
|
|
1383 61 /usr/local/lib/xemacs-19.13/etc/ns
|
|
1384 43 /usr/local/lib/xemacs-19.13/etc/gnus
|
282
|
1385 @end format
|
175
|
1386
|
|
1387 These are support directories for various packages. In general they
|
|
1388 match a directory under ./xemacs-19.13/lib/xemacs-19.13/lisp/. If you
|
|
1389 do not require the package, you may delete or gzip the support too.
|
|
1390
|
282
|
1391 @format
|
175
|
1392 1959 /usr/local/lib/xemacs-19.13/etc
|
|
1393 175 /usr/local/lib/xemacs-19.13/lisp/bytecomp
|
|
1394 340 /usr/local/lib/xemacs-19.13/lisp/calendar
|
|
1395 342 /usr/local/lib/xemacs-19.13/lisp/comint
|
|
1396 517 /usr/local/lib/xemacs-19.13/lisp/dired
|
|
1397 42 /usr/local/lib/xemacs-19.13/lisp/electric
|
|
1398 212 /usr/local/lib/xemacs-19.13/lisp/emulators
|
|
1399 238 /usr/local/lib/xemacs-19.13/lisp/energize
|
|
1400 289 /usr/local/lib/xemacs-19.13/lisp/gnus
|
|
1401 457 /usr/local/lib/xemacs-19.13/lisp/ilisp
|
|
1402 1439 /usr/local/lib/xemacs-19.13/lisp/modes
|
|
1403 2276 /usr/local/lib/xemacs-19.13/lisp/packages
|
|
1404 1040 /usr/local/lib/xemacs-19.13/lisp/prim
|
|
1405 176 /usr/local/lib/xemacs-19.13/lisp/pcl-cvs
|
|
1406 154 /usr/local/lib/xemacs-19.13/lisp/rmail
|
|
1407 3 /usr/local/lib/xemacs-19.13/lisp/epoch
|
|
1408 45 /usr/local/lib/xemacs-19.13/lisp/term
|
|
1409 860 /usr/local/lib/xemacs-19.13/lisp/utils
|
|
1410 851 /usr/local/lib/xemacs-19.13/lisp/vm
|
|
1411 13 /usr/local/lib/xemacs-19.13/lisp/vms
|
|
1412 157 /usr/local/lib/xemacs-19.13/lisp/x11
|
|
1413 19 /usr/local/lib/xemacs-19.13/lisp/tooltalk
|
|
1414 14 /usr/local/lib/xemacs-19.13/lisp/sunpro
|
|
1415 291 /usr/local/lib/xemacs-19.13/lisp/games
|
|
1416 198 /usr/local/lib/xemacs-19.13/lisp/edebug
|
|
1417 619 /usr/local/lib/xemacs-19.13/lisp/w3
|
|
1418 229 /usr/local/lib/xemacs-19.13/lisp/eos
|
|
1419 55 /usr/local/lib/xemacs-19.13/lisp/iso
|
|
1420 59 /usr/local/lib/xemacs-19.13/lisp/mailcrypt
|
|
1421 187 /usr/local/lib/xemacs-19.13/lisp/eterm
|
|
1422 356 /usr/local/lib/xemacs-19.13/lisp/ediff
|
|
1423 408 /usr/local/lib/xemacs-19.13/lisp/hyperbole/kotl
|
|
1424 1262 /usr/local/lib/xemacs-19.13/lisp/hyperbole
|
|
1425 247 /usr/local/lib/xemacs-19.13/lisp/hm--html-menus
|
|
1426 161 /usr/local/lib/xemacs-19.13/lisp/mh-e
|
|
1427 299 /usr/local/lib/xemacs-19.13/lisp/viper
|
|
1428 53 /usr/local/lib/xemacs-19.13/lisp/oobr/tree-x
|
|
1429 4 /usr/local/lib/xemacs-19.13/lisp/oobr/tree-nx/English.lproj/DocWindow.nib
|
|
1430 3 /usr/local/lib/xemacs-19.13/lisp/oobr/tree-nx/English.lproj/InfoPanel.nib
|
|
1431 3 /usr/local/lib/xemacs-19.13/lisp/oobr/tree-nx/English.lproj/TreeView.nib
|
|
1432 11 /usr/local/lib/xemacs-19.13/lisp/oobr/tree-nx/English.lproj
|
|
1433 53 /usr/local/lib/xemacs-19.13/lisp/oobr/tree-nx
|
|
1434 466 /usr/local/lib/xemacs-19.13/lisp/oobr
|
|
1435 14142 /usr/local/lib/xemacs-19.13/lisp
|
282
|
1436 @end format
|
175
|
1437
|
|
1438 These are all Emacs Lisp source code and bytecompiled object code. You
|
|
1439 may safely gzip everything named *.el here. You may remove any package
|
|
1440 you don't use. @emph{Nothing bad will happen if you delete a package
|
|
1441 that you do not use}. You must be sure you do not use it though, so be
|
|
1442 conservative at first.
|
|
1443
|
|
1444 Possible candidates for deletion include w3 (newer versions exist, or
|
|
1445 you may just use Lynx or Netscape for web browsing), games, hyperbole,
|
|
1446 mh-e, hm--html-menus (better packages exist), vm, viper, oobr, gnus (new
|
|
1447 versions exist), etc. Ask yourself, @emph{Do I ever want to use this
|
|
1448 package?} If the answer is no, then it is a candidate for removal.
|
|
1449
|
|
1450 First, gzip all the .el files. Then go about package by package and
|
|
1451 start gzipping the .elc files. Then run XEmacs and do whatever it is
|
|
1452 you normally do. If nothing bad happens, then delete the directory. Be
|
|
1453 conservative about deleting directories, and it would be handy to have a
|
|
1454 backup tape around in case you get too zealous.
|
|
1455
|
|
1456 @file{prim}, @file{modes}, @file{packages}, and @file{utils} are four
|
|
1457 directories you definitely do @strong{not} want to delete, although
|
|
1458 certain packages can be removed from them if you do not use them.
|
|
1459
|
|
1460 @example
|
|
1461 1972 /usr/local/lib/xemacs-19.13/info
|
|
1462 @end example
|
|
1463
|
|
1464 These are online texinfo sources. You may either gzip them or remove
|
|
1465 them. In either case, @kbd{C-h i} (info mode) will no longer work.
|
|
1466
|
|
1467 @example
|
|
1468 20778 /usr/local/lib/xemacs-19.13
|
|
1469 @end example
|
|
1470
|
|
1471 The 20MB achieved is less than half of what the full distribution takes up,
|
|
1472 @strong{and} can be achieved without deleting a single file.
|
|
1473 @end quotation
|
|
1474
|
274
|
1475 @email{boffi@@hp735.stru.polimi.it, Giacomo Boffi} provides this procedure:
|
175
|
1476
|
|
1477 @quotation
|
|
1478 Substitute @file{/usr/local/lib/} with the path where the xemacs tree is
|
|
1479 rooted, then use this script:
|
|
1480
|
|
1481 @example
|
|
1482 #!/bin/sh
|
|
1483
|
|
1484 r=/usr/local/lib/xemacs-19.13/lisp
|
|
1485
|
|
1486 cd $r ; rm -f cmpr ; touch cmpr
|
|
1487
|
|
1488 du -s .
|
|
1489
|
|
1490 for d in * ; do
|
|
1491 if test -d $d ; then
|
|
1492 cd $d
|
|
1493 for f in *.el ; do
|
|
1494 # compress (remove) only (ONLY) the sources that have a
|
282
|
1495 # corresponding compiled file --- do not (DO NOT)
|
274
|
1496 # touch other sources
|
175
|
1497 if test -f $@{f@}c ; then gzip -v9 $f >> $r/cmpr ; fi
|
|
1498 done
|
|
1499 cd ..
|
|
1500 fi
|
|
1501 done
|
|
1502
|
|
1503 du -s .
|
|
1504 @end example
|
|
1505
|
|
1506 A step beyond would be substituting @samp{rm -f} for @samp{gzip -v9},
|
|
1507 but you have to be desperate for removing the sources (remember that
|
|
1508 emacs can access compressed files transparently).
|
|
1509
|
|
1510 Also, a good megabyte could easily be trimmed from the $r/../etc
|
|
1511 directory, e.g., the termcap files, some O+NEWS, others that I don't
|
|
1512 remember as well.
|
|
1513 @end quotation
|
|
1514
|
|
1515 @quotation
|
282
|
1516 XEmacs 21.0 will unbundle the lisp hierarchy and allow the installer
|
126
|
1517 to choose exactly how much support code gets installed.
|
82
|
1518 @end quotation
|
|
1519
|
|
1520 @node Q2.0.3, Q2.0.4, Q2.0.2, Installation
|
274
|
1521 @unnumberedsubsec Q2.0.3: Compiling XEmacs with Netaudio.
|
82
|
1522
|
|
1523 What is the best way to compile XEmacs with the netaudio system, since I
|
|
1524 have got the netaudio system compiled but installed at a weird place, I
|
|
1525 am not root. Also in the READMEs it does not say anything about
|
|
1526 compiling with the audioserver?
|
|
1527
|
|
1528 You should only need to add some stuff to the configure command line.
|
|
1529 To tell it to compile in netaudio support: @samp{--with-sound=both}, or
|
|
1530 @samp{--with-sound=nas} if you don't want native sound support for some
|
|
1531 reason.) To tell it where to find the netaudio includes and libraries:
|
16
|
1532
|
|
1533 @example
|
82
|
1534 --site-libraries=WHATEVER
|
|
1535 --site-includes=WHATEVER
|
|
1536 @end example
|
|
1537
|
|
1538 Then (fingers crossed) it should compile and it will use netaudio if you
|
|
1539 have a server running corresponding to the X server. The netaudio server
|
|
1540 has to be there when XEmacs starts. If the netaudio server goes away and
|
|
1541 another is run, XEmacs should cope (fingers crossed, error handling in
|
|
1542 netaudio isn't perfect).
|
|
1543
|
|
1544 BTW, netaudio has been renamed as it has a name clash with something
|
|
1545 else, so if you see references to NAS or Network Audio System, it's the
|
|
1546 same thing. It also might be found at
|
274
|
1547 @uref{ftp://ftp.x.org/contrib/audio/nas/}.
|
82
|
1548
|
|
1549 @node Q2.0.4, Q2.0.5, Q2.0.3, Installation
|
274
|
1550 @unnumberedsubsec Q2.0.4: Problems with Linux and ncurses.
|
82
|
1551
|
|
1552 On Linux 1.3.98 with termcap 2.0.8 and the ncurses that came with libc
|
126
|
1553 5.2.18, XEmacs 20.0b20 is unable to open a tty device:
|
82
|
1554
|
|
1555 @example
|
|
1556 src/xemacs -nw -q
|
282
|
1557 Initialization error:
|
|
1558 @iftex
|
274
|
1559 @*
|
282
|
1560 @end iftex
|
274
|
1561 Terminal type `xterm' undefined (or can't access database?)
|
82
|
1562 @end example
|
|
1563
|
274
|
1564 @email{ben@@666.com, Ben Wing} writes:
|
82
|
1565
|
|
1566 @quotation
|
|
1567 Your ncurses configuration is messed up. Your /usr/lib/terminfo is a
|
|
1568 bad pointer, perhaps to a CD-ROM that is not inserted.
|
|
1569 @end quotation
|
|
1570
|
|
1571 @node Q2.0.5, Q2.0.6, Q2.0.4, Installation
|
274
|
1572 @unnumberedsubsec Q2.0.5: Do I need X11 to run XEmacs?
|
82
|
1573
|
|
1574 No. The name @dfn{XEmacs} is unfortunate in the sense that it is
|
|
1575 @strong{not} an X Window System-only version of Emacs. Starting with
|
|
1576 19.14 XEmacs has full color support on a color capable character
|
|
1577 terminal.
|
|
1578
|
|
1579 @node Q2.0.6, Q2.0.7, Q2.0.5, Installation
|
274
|
1580 @unnumberedsubsec Q2.0.6: I'm having strange crashes. What do I do?
|
82
|
1581
|
|
1582 There have been a variety of reports of crashes due to compilers with
|
|
1583 buggy optimizers. Please see the @file{PROBLEMS} file that comes with
|
|
1584 XEmacs to read what it says about your platform.
|
|
1585
|
|
1586 @node Q2.0.7, Q2.0.8, Q2.0.6, Installation
|
274
|
1587 @unnumberedsubsec Q2.0.7: Libraries in non-standard locations
|
82
|
1588
|
|
1589 I have x-faces, jpeg, xpm etc. all in different places. I've tried
|
|
1590 space-separated, comma-separated, several --site-libraries, all to no
|
|
1591 avail.
|
|
1592
|
|
1593 @example
|
|
1594 --site-libraries='/path/one /path/two /path/etc'
|
|
1595 @end example
|
|
1596
|
|
1597 @node Q2.0.8, Q2.0.9, Q2.0.7, Installation
|
274
|
1598 @unnumberedsubsec Q2.0.8: can't resolve symbol _h_errno
|
82
|
1599
|
|
1600 You are using the Linux/ELF distribution of XEmacs 19.14, and your ELF
|
|
1601 libraries are out of date. You have the following options:
|
|
1602
|
|
1603 @enumerate
|
|
1604 @item
|
|
1605 Upgrade your libc to at least 5.2.16 (better is 5.2.18, 5.3.12, or
|
|
1606 5.4.10).
|
|
1607
|
|
1608 @item
|
|
1609 Patch the XEmacs binary by replacing all occurrences of
|
282
|
1610 @samp{_h_errno^@@} with
|
|
1611 @iftex
|
274
|
1612 @*
|
282
|
1613 @end iftex
|
274
|
1614 @samp{h_errno^@@^@@}. Any version of Emacs will
|
82
|
1615 suffice. If you don't understand how to do this, don't do it.
|
|
1616
|
|
1617 @item
|
|
1618 Rebuild XEmacs yourself -- any working ELF version of libc should be
|
|
1619 O.K.
|
|
1620 @end enumerate
|
|
1621
|
274
|
1622 @email{hniksic@@srce.hr, Hrvoje Niksic} writes:
|
82
|
1623
|
|
1624 @quotation
|
|
1625 Why not use a Perl one-liner for No. 2?
|
|
1626
|
|
1627 @example
|
274
|
1628 perl -pi -e 's/_h_errno\0/h_errno\0\0/g' \
|
|
1629 /usr/local/bin/xemacs-19.14
|
82
|
1630 @end example
|
|
1631
|
|
1632 NB: You @emph{must} patch @file{/usr/local/bin/xemacs-19.14}, and not
|
|
1633 @file{xemacs} because @file{xemacs} is a link to @file{xemacs-19.14};
|
|
1634 the Perl @samp{-i} option will cause unwanted side-effects if applied to
|
|
1635 a symbolic link.
|
|
1636 @end quotation
|
|
1637
|
274
|
1638 @email{steve@@xemacs.org, SL Baur} writes:
|
116
|
1639
|
|
1640 @quotation
|
|
1641 If you build against a recent libc-5.4 (late enough to have caused
|
|
1642 problems earlier in the beta cycle) and then run with an earlier version
|
|
1643 of libc, you get a
|
|
1644
|
|
1645 @example
|
|
1646 $ xemacs
|
|
1647 xemacs: can't resolve symbol '__malloc_hook'
|
|
1648 zsh: 7942 segmentation fault (core dumped) xemacs
|
|
1649 @end example
|
|
1650
|
|
1651 (Example binary compiled against libc-5.4.23 and run with libc-5.4.16).
|
|
1652
|
|
1653 The solution is to upgrade to at least libc-5.4.23. Sigh. Drat.
|
|
1654 @end quotation
|
|
1655
|
82
|
1656 @node Q2.0.9, Q2.0.10, Q2.0.8, Installation
|
274
|
1657 @unnumberedsubsec Q2.0.9: Where do I find external libraries?
|
82
|
1658
|
|
1659 All external libraries used by XEmacs can be found at the XEmacs FTP
|
282
|
1660 site
|
274
|
1661 @iftex
|
|
1662 @*
|
282
|
1663 @end iftex
|
|
1664 @uref{ftp://ftp.xemacs.org/pub/xemacs/aux/}.
|
|
1665
|
|
1666 @c Changed June Link above, <URL:ftp://ftp.xemacs.org/pub/aux/> was dead.
|
207
|
1667 @c This list is a pain in the you-know-what to keep in synch with the
|
|
1668 @c world.
|
163
|
1669 The canonical locations (at the time of this writing) are as follows:
|
82
|
1670
|
|
1671 @table @asis
|
|
1672 @item JPEG
|
274
|
1673 @uref{ftp://ftp.uu.net/graphics/jpeg/}. Version 6a is current.
|
282
|
1674 @c Check from host with legal IP address
|
82
|
1675 @item XPM
|
274
|
1676 @uref{ftp://ftp.x.org/contrib/libraries/}. Version 3.4j is current.
|
82
|
1677 Older versions of this package are known to cause XEmacs crashes.
|
|
1678
|
|
1679 @item TIFF
|
274
|
1680 @uref{ftp://ftp.sgi.com/graphics/tiff/}. v3.4 is current. The latest
|
82
|
1681 beta is v3.4b035. There is a HOWTO here.
|
|
1682
|
|
1683 @item PNG
|
274
|
1684 @uref{ftp://ftp.uu.net/graphics/png/}. 0.89c is current. XEmacs
|
82
|
1685 requires a fairly recent version to avoid using temporary files.
|
282
|
1686 @c Check from host with legal IP address
|
82
|
1687
|
274
|
1688 @uref{ftp://swrinde.nde.swri.edu/pub/png/src/}
|
82
|
1689
|
|
1690 @item Compface
|
274
|
1691 @uref{ftp://ftp.cs.indiana.edu/pub/faces/compface/}. This library has
|
82
|
1692 been frozen for about 6 years, and is distributed without version
|
|
1693 numbers. @emph{It should be compiled with the same options that X11 was
|
|
1694 compiled with on your system}. The version of this library at
|
|
1695 XEmacs.org includes the @file{xbm2xface.pl} script, written by
|
274
|
1696 @email{stig@@hackvan.com}, which may be useful when generating your own xface.
|
82
|
1697
|
|
1698 @item NAS
|
274
|
1699 @uref{ftp://ftp.x.org/contrib/audio/nas/}.
|
82
|
1700 Version 1.2p5 is current. There is a FAQ here.
|
|
1701 @end table
|
|
1702
|
|
1703 @node Q2.0.10, Q2.0.11, Q2.0.9, Installation
|
274
|
1704 @unnumberedsubsec Q2.0.10: After I run configure I find a core dump, is something wrong?
|
82
|
1705
|
|
1706 Not necessarily. If you have GNU sed 3.0 you should downgrade it to
|
|
1707 2.05. From the @file{README} at prep.ai.mit.edu:
|
|
1708
|
|
1709 @quotation
|
|
1710 sed 3.0 has been withdrawn from distribution. It has major revisions,
|
|
1711 which mostly seem to be improvements; but it turns out to have bugs too
|
|
1712 which cause trouble in some common cases.
|
|
1713
|
|
1714 Tom Lord won't be able to work fixing the bugs until May. So in the
|
|
1715 mean time, we've decided to withdraw sed 3.0 from distribution and make
|
|
1716 version 2.05 once again the recommended version.
|
|
1717 @end quotation
|
|
1718
|
|
1719 It has also been observed that the vfork test on Solaris will leave a
|
126
|
1720 core dump.
|
82
|
1721
|
|
1722 @node Q2.0.11, Q2.0.12, Q2.0.10, Installation
|
274
|
1723 @unnumberedsubsec Q2.0.11: XEmacs doesn't resolve hostnames.
|
82
|
1724
|
|
1725 This is the result of a long-standing problem with SunOS and the fact
|
|
1726 that stock SunOS systems do not ship with DNS resolver code in libc.
|
|
1727
|
274
|
1728 @email{ckd@@loiosh.kei.com, Christopher Davis} writes:
|
82
|
1729
|
|
1730 @quotation
|
|
1731 That's correct [The SunOS 4.1.3 precompiled binaries don't do name
|
|
1732 lookup]. Since Sun figured that everyone used NIS to do name lookups
|
|
1733 (that DNS thing was apparently only a passing fad, right?), the stock
|
|
1734 SunOS 4.x systems don't have DNS-based name lookups in libc.
|
|
1735
|
|
1736 This is also why Netscape ships two binaries for SunOS 4.1.x.
|
|
1737
|
|
1738 The best solution is to compile it yourself; the configure script will
|
|
1739 check to see if you've put DNS in the shared libc and will then proceed
|
|
1740 to link against the DNS resolver library code.
|
|
1741 @end quotation
|
|
1742
|
|
1743 @node Q2.0.12, Q2.0.13, Q2.0.11, Installation
|
274
|
1744 @unnumberedsubsec Q2.0.12: Why can't I strip XEmacs?
|
|
1745
|
|
1746 @email{cognot@@fronsac.ensg.u-nancy.fr, Richard Cognot} writes:
|
82
|
1747
|
|
1748 @quotation
|
|
1749 Because of the way XEmacs (and every other Emacsen, AFAIK) is built. The
|
|
1750 link gives you a bare-boned emacs (called temacs). temacs is then run,
|
|
1751 preloading some of the lisp files. The result is then dumped into a new
|
|
1752 executable, named xemacs, which will contain all of the preloaded lisp
|
|
1753 functions and data.
|
|
1754
|
|
1755 Now, during the dump itself, the executable (code+data+symbols) is
|
|
1756 written on disk using a special unexec() function. This function is
|
|
1757 obviously heavily system dependent. And on some systems, it leads to an
|
|
1758 executable which, although valid, cannot be stripped without damage. If
|
|
1759 memory serves, this is especially the case for AIX binaries. On other
|
|
1760 architecture it might work OK.
|
|
1761
|
|
1762 The Right Way to strip the emacs binary is to strip temacs prior to
|
|
1763 dumping xemacs. This will always work, although you can do that only if
|
|
1764 you install from sources (as temacs is @file{not} part of the binary
|
|
1765 kits).
|
|
1766 @end quotation
|
|
1767
|
274
|
1768 @email{nat@@nataa.fr.eu.org, Nat Makarevitch} writes:
|
82
|
1769
|
|
1770 @quotation
|
|
1771 Here is the trick:
|
|
1772
|
|
1773 @enumerate
|
|
1774 @item
|
163
|
1775 [ ./configure; make ]
|
82
|
1776
|
|
1777 @item
|
163
|
1778 rm src/xemacs
|
82
|
1779
|
|
1780 @item
|
163
|
1781 strip src/temacs
|
82
|
1782
|
|
1783 @item
|
|
1784 make
|
|
1785
|
|
1786 @item
|
|
1787 cp src/xemacs /usr/local/bin/xemacs
|
|
1788
|
|
1789 @item
|
282
|
1790 cp lib-src/DOC-19.16-XEmacs
|
274
|
1791 @iftex
|
|
1792 \ @*
|
282
|
1793 @end iftex
|
274
|
1794 /usr/local/lib/xemacs-19.16/i586-unknown-linuxaout
|
82
|
1795 @end enumerate
|
|
1796 @end quotation
|
|
1797
|
126
|
1798 @node Q2.0.13, Q2.0.14, Q2.0.12, Installation
|
274
|
1799 @unnumberedsubsec Q2.0.13: Problems linking with Gcc on Solaris
|
82
|
1800
|
|
1801 There are known difficulties linking with Gnu ld on Solaris. A typical
|
|
1802 error message might look like:
|
|
1803
|
|
1804 @example
|
282
|
1805 unexec(): dlopen(../dynodump/dynodump.so): ld.so.1: ./temacs:
|
|
1806 fatal: relocation error:
|
82
|
1807 symbol not found: main: referenced in ../dynodump/dynodump.so
|
|
1808 @end example
|
|
1809
|
274
|
1810 @email{martin@@xemacs.org, Martin Buchholz} writes:
|
82
|
1811
|
|
1812 @quotation
|
|
1813 You need to specify @samp{-fno-gnu-linker} as part of your flags to pass
|
|
1814 to ld. Future releases of XEmacs will try to do this automatically.
|
|
1815 @end quotation
|
|
1816
|
126
|
1817 @node Q2.0.14, Q2.1.1, Q2.0.13, Installation
|
274
|
1818 @unnumberedsubsec Q2.0.14: Make on HP/UX 9 fails after linking temacs
|
126
|
1819
|
213
|
1820 Problem when building xemacs-19.16 on hpux 9:
|
126
|
1821
|
274
|
1822 @email{cognot@@ensg.u-nancy.fr, Richard Cognot} writes:
|
126
|
1823
|
|
1824 @quotation
|
|
1825 make on hpux fails after linking temacs with a message:
|
|
1826
|
|
1827 @example
|
|
1828 "make: don't know how to make .y."
|
|
1829 @end example
|
|
1830
|
|
1831 Solution: This is a problem with HP make revision 70.X. Either use GNU
|
|
1832 make, or install PHCO_6552, which will bring make to revision
|
|
1833 72.24.1.17.
|
|
1834 @end quotation
|
|
1835
|
|
1836
|
|
1837 @node Q2.1.1, Q2.1.2, Q2.0.14, Installation
|
274
|
1838 @unnumberedsec 2.1: Trouble Shooting
|
|
1839 @unnumberedsubsec Q2.1.1: Help! XEmacs just crashed on me!
|
82
|
1840
|
|
1841 First of all, don't panic. Whenever XEmacs crashes, it tries extremely
|
163
|
1842 hard to auto-save all of your files before dying. (The main time that
|
82
|
1843 this will not happen is if the machine physically lost power or if you
|
163
|
1844 killed the XEmacs process using @code{kill -9}). The next time you try
|
82
|
1845 to edit those files, you will be informed that a more recent auto-save
|
|
1846 file exists. You can use @kbd{M-x recover-file} to retrieve the
|
|
1847 auto-saved version of the file.
|
|
1848
|
|
1849 Starting with 19.14, you may use the command @kbd{M-x recover-session}
|
|
1850 after a crash to pick up where you left off.
|
|
1851
|
|
1852 Now, XEmacs is not perfect, and there may occasionally be times, or
|
|
1853 particular sequences of actions, that cause it to crash. If you can
|
|
1854 come up with a reproducible way of doing this (or even if you have a
|
|
1855 pretty good memory of exactly what you were doing at the time), the
|
|
1856 maintainers would be very interested in knowing about it. Post a
|
274
|
1857 message to comp.emacs.xemacs or send mail to @email{crashes@@xemacs.org}.
|
82
|
1858 Please note that the @samp{crashes} address is exclusively for crash
|
|
1859 reports.
|
|
1860
|
|
1861 If at all possible, include a stack backtrace of the core dump that was
|
|
1862 produced. This shows where exactly things went wrong, and makes it much
|
|
1863 easier to diagnose problems. To do this, you need to locate the core
|
|
1864 file (it's called @file{core}, and is usually sitting in the directory
|
|
1865 that you started XEmacs from, or your home directory if that other
|
|
1866 directory was not writable). Then, go to that directory and execute a
|
|
1867 command like:
|
|
1868
|
|
1869 @example
|
|
1870 gdb `which xemacs` core
|
|
1871 @end example
|
|
1872
|
|
1873 and then issue the command @samp{where} to get the stack backtrace. You
|
|
1874 might have to use @code{dbx} or some similar debugger in place of
|
|
1875 @code{gdb}. If you don't have any such debugger available, complain to
|
|
1876 your system administrator.
|
|
1877
|
|
1878 It's possible that a core file didn't get produced, in which case you're
|
|
1879 out of luck. Go complain to your system administrator and tell him not
|
|
1880 to disable core files by default. Also @xref{Q2.1.15} for tips and
|
|
1881 techniques for dealing with a debugger.
|
|
1882
|
|
1883 When making a problem report make sure that:
|
|
1884
|
|
1885 @enumerate
|
|
1886 @item
|
|
1887 Report @strong{all} of the information output by XEmacs during the
|
|
1888 crash.
|
|
1889
|
|
1890 @item
|
|
1891 You mention what O/S & Hardware you are running XEmacs on.
|
|
1892
|
|
1893 @item
|
|
1894 What version of XEmacs you are running.
|
|
1895
|
|
1896 @item
|
|
1897 What build options you are using.
|
|
1898
|
|
1899 @item
|
|
1900 If the problem is related to graphics, we will also need to know what
|
|
1901 version of the X Window System you are running, and what window manager
|
|
1902 you are using.
|
|
1903
|
|
1904 @item
|
|
1905 If the problem happened on a tty, please include the terminal type.
|
|
1906 @end enumerate
|
|
1907
|
|
1908 @node Q2.1.2, Q2.1.3, Q2.1.1, Installation
|
274
|
1909 @unnumberedsubsec Q2.1.2: Cryptic Minibuffer messages.
|
82
|
1910
|
|
1911 When I try to use some particular option of some particular package, I
|
|
1912 get a cryptic error in the minibuffer.
|
|
1913
|
|
1914 If you can't figure out what's going on, select Options/General
|
|
1915 Options/Debug on Error from the Menubar and then try and make the error
|
|
1916 happen again. This will give you a backtrace that may be enlightening.
|
|
1917 If not, try reading through this FAQ; if that fails, you could try
|
|
1918 posting to comp.emacs.xemacs (making sure to include the backtrace) and
|
|
1919 someone may be able to help. If you can identify which Emacs lisp
|
|
1920 source file the error is coming from you can get a more detailed stack
|
|
1921 backtrace by doing the following:
|
|
1922
|
|
1923 @enumerate
|
|
1924 @item
|
|
1925 Visit the .el file in an XEmacs buffer.
|
|
1926
|
|
1927 @item
|
|
1928 Issue the command @kbd{M-x eval-current-buffer}.
|
|
1929
|
|
1930 @item
|
|
1931 Reproduce the error.
|
|
1932 @end enumerate
|
|
1933
|
|
1934 Depending on the version of XEmacs, you may either select Edit->Show
|
|
1935 Messages (19.13 and earlier) or Help->Recent Keystrokes/Messages (19.14
|
|
1936 and later) from the menubar to see the most recent messages. This
|
|
1937 command is bound to @kbd{C-h l} by default.
|
|
1938
|
|
1939 @node Q2.1.3, Q2.1.4, Q2.1.2, Installation
|
274
|
1940 @unnumberedsubsec Q2.1.3: Translation Table Syntax messages at Startup
|
82
|
1941
|
|
1942 I get tons of translation table syntax error messages during startup.
|
|
1943 How do I get rid of them?
|
|
1944
|
|
1945 There are two causes of this problem. The first usually only strikes
|
|
1946 people using the prebuilt binaries. The culprit in both cases is the
|
|
1947 file @file{XKeysymDB}.
|
|
1948
|
|
1949 @itemize @bullet
|
|
1950 @item
|
|
1951 The binary cannot find the @file{XKeysymDB} file. The location is
|
|
1952 hardcoded at compile time so if the system the binary was built on puts
|
|
1953 it a different place than your system does, you have problems. To fix,
|
|
1954 set the environment variable @var{XKEYSYMDB} to the location of the
|
|
1955 @file{XKeysymDB} file on your system or to the location of the one
|
|
1956 included with XEmacs which should be at
|
274
|
1957 @iftex
|
|
1958 @*
|
282
|
1959 @end iftex
|
213
|
1960 @file{<xemacs_root_directory>/lib/xemacs-19.16/etc/XKeysymDB}.
|
82
|
1961
|
|
1962 @item
|
|
1963 The binary is finding the XKeysymDB but it is out-of-date on your system
|
|
1964 and does not contain the necessary lines. Either ask your system
|
|
1965 administrator to replace it with the one which comes with XEmacs (which
|
|
1966 is the stock R6 version and is backwards compatible) or set your
|
|
1967 @var{XKEYSYMDB} variable to the location of XEmacs's described above.
|
|
1968 @end itemize
|
|
1969
|
|
1970 @node Q2.1.4, Q2.1.5, Q2.1.3, Installation
|
274
|
1971 @unnumberedsubsec Q2.1.4: Startup warnings about deducing proper fonts?
|
82
|
1972
|
|
1973 How can I avoid the startup warnings about deducing proper fonts?
|
|
1974
|
|
1975 This is highly dependent on your installation, but try with the
|
|
1976 following font as your base font for XEmacs and see what it does:
|
|
1977
|
282
|
1978 @format
|
82
|
1979 -adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1
|
282
|
1980 @end format
|
82
|
1981
|
|
1982 More precisely, do the following in your resource file:
|
|
1983
|
282
|
1984 @format
|
|
1985 Emacs.default.attributeFont: \
|
|
1986 -adobe-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1
|
|
1987 @end format
|
16
|
1988
|
82
|
1989 If you just don't want to see the @samp{*Warnings*} buffer at startup
|
|
1990 time, you can set this:
|
|
1991
|
|
1992 @lisp
|
|
1993 (setq display-warning-minimum-level 'error)
|
|
1994 @end lisp
|
|
1995
|
|
1996 The buffer still exists; it just isn't in your face.
|
|
1997
|
|
1998 @node Q2.1.5, Q2.1.6, Q2.1.4, Installation
|
274
|
1999 @unnumberedsubsec Q2.1.5: XEmacs cannot connect to my X Terminal!
|
82
|
2000
|
|
2001 Help! I can not get XEmacs to display on my Envizex X-terminal!
|
|
2002
|
|
2003 Try setting the @var{DISPLAY} variable using the numeric IP address of
|
|
2004 the host you are running XEmacs from.
|
|
2005
|
|
2006 @node Q2.1.6, Q2.1.7, Q2.1.5, Installation
|
274
|
2007 @unnumberedsubsec Q2.1.6: XEmacs just locked up my Linux X server!
|
82
|
2008
|
|
2009 There have been several reports of the X server locking up under Linux.
|
|
2010 In all reported cases removing speedo and scaled fonts from the font
|
|
2011 path corrected the problem. This can be done with the command
|
163
|
2012 @code{xset}.
|
82
|
2013
|
|
2014 It is possible that using a font server may also solve the problem.
|
|
2015
|
|
2016 @node Q2.1.7, Q2.1.8, Q2.1.6, Installation
|
274
|
2017 @unnumberedsubsec Q2.1.7: HP Alt key as Meta.
|
82
|
2018
|
|
2019 How can I make XEmacs recognize the Alt key of my HP workstation as a
|
|
2020 Meta key?
|
|
2021
|
|
2022 Put the following line into a file and load it with xmodmap(1) before
|
|
2023 starting XEmacs:
|
|
2024
|
|
2025 @example
|
|
2026 remove Mod1 = Mode_switch
|
|
2027 @end example
|
|
2028
|
|
2029 @node Q2.1.8, Q2.1.9, Q2.1.7, Installation
|
274
|
2030 @unnumberedsubsec Q2.1.8: got (wrong-type-argument color-instance-p nil)
|
|
2031
|
|
2032 @email{nataliek@@rd.scitec.com.au, Natalie Kershaw} writes:
|
82
|
2033
|
|
2034 @quotation
|
|
2035 I am trying to run xemacs 19.13 under X11R4. Whenever I move the mouse I
|
|
2036 get the following error. Has anyone seen anything like this? This
|
|
2037 doesn't occur on X11R5.
|
|
2038
|
|
2039 @lisp
|
282
|
2040 Signalling:
|
|
2041 (error "got (wrong-type-argument color-instance-p nil)
|
274
|
2042 and I don't know why!")
|
82
|
2043 @end lisp
|
|
2044 @end quotation
|
|
2045
|
274
|
2046 @email{map01kd@@gold.ac.uk, dinos} writes:
|
82
|
2047
|
|
2048 @quotation
|
|
2049 I think this is due to undefined resources; You need to define color
|
|
2050 backgrounds and foregrounds into your @file{.../app-defaults/Emacs}
|
|
2051 like:
|
|
2052
|
|
2053 @example
|
|
2054 *Foreground: Black ;everything will be of black on grey95,
|
|
2055 *Background: Grey95 ;unless otherwise specified.
|
|
2056 *cursorColor: Red3 ;red3 cursor with grey95 border.
|
|
2057 *pointerColor: Red3 ;red3 pointer with grey95 border.
|
|
2058 @end example
|
|
2059 @end quotation
|
|
2060
|
|
2061 Natalie Kershaw adds:
|
|
2062
|
|
2063 @quotation
|
|
2064 What fixed the problem was adding some more colors to the X color
|
|
2065 database (copying the X11R5 colors over), and also defining the
|
|
2066 following resources:
|
|
2067
|
|
2068 @example
|
|
2069 xemacs*cursorColor: black
|
|
2070 xemacs*pointerColor: black
|
|
2071 @end example
|
|
2072
|
282
|
2073 With the new colors installed the problem still occurs if the above
|
82
|
2074 resources are not defined.
|
|
2075
|
282
|
2076 If the new colors are not present then an additional error occurs on
|
82
|
2077 XEmacs startup, which says @samp{Color Red3} not defined.
|
|
2078 @end quotation
|
|
2079
|
|
2080 @node Q2.1.9, Q2.1.10, Q2.1.8, Installation
|
274
|
2081 @unnumberedsubsec Q2.1.9: XEmacs causes my OpenWindows 3.0 server to crash.
|
82
|
2082
|
|
2083 The OpenWindows 3.0 server is incredibly buggy. Your best bet is to
|
|
2084 replace it with one from the generic MIT X11 release. You might also
|
|
2085 try disabling parts of your @file{.emacs}, like enabling background
|
|
2086 pixmaps.
|
|
2087
|
|
2088 @node Q2.1.10, Q2.1.11, Q2.1.9, Installation
|
274
|
2089 @unnumberedsubsec Q2.1.10: Warnings from incorrect key modifiers.
|
82
|
2090
|
|
2091 The following information comes from the @file{PROBLEMS} file that comes
|
|
2092 with XEmacs.
|
|
2093
|
|
2094 If you're having troubles with HP/UX it is because HP/UX defines the
|
|
2095 modifiers wrong in X. Here is a shell script to fix the problem; be
|
|
2096 sure that it is run after VUE configures the X server.
|
|
2097
|
|
2098 @example
|
|
2099 #! /bin/sh
|
|
2100 xmodmap 2> /dev/null - << EOF
|
|
2101 keysym Alt_L = Meta_L
|
|
2102 keysym Alt_R = Meta_R
|
|
2103 EOF
|
|
2104
|
|
2105 xmodmap - << EOF
|
|
2106 clear mod1
|
|
2107 keysym Mode_switch = NoSymbol
|
|
2108 add mod1 = Meta_L
|
|
2109 keysym Meta_R = Mode_switch
|
|
2110 add mod2 = Mode_switch
|
|
2111 EOF
|
|
2112 @end example
|
|
2113
|
|
2114 @node Q2.1.11, Q2.1.12, Q2.1.10, Installation
|
282
|
2115 @unnumberedsubsec Q2.1.11: @samp{Can't instantiate image error...} in toolbar
|
|
2116 @c New
|
|
2117
|
|
2118 @email{expt@@alanine.ram.org, Dr. Ram Samudrala} writes:
|
|
2119
|
|
2120 I just installed the XEmacs (20.4-2) RPMS that I downloaded from
|
|
2121 @uref{http://www.xemacs.org/}. Everything works fine, except that when
|
|
2122 I place my mouse over the toolbar, it beeps and gives me this message:
|
|
2123
|
|
2124 @example
|
|
2125 Can't instantiate image (probably cached):
|
|
2126 [xbm :mask-file "/usr/include/X11/bitmaps/leftptrmsk :mask-data
|
|
2127 (16 16 <strange control characters> ...
|
|
2128 @end example
|
|
2129
|
|
2130 @email{kyle_jones@@wonderworks.com, Kyle Jones} writes:
|
|
2131 @quotation
|
|
2132 This is problem specific to some Chips and Technologies video
|
|
2133 chips, when running XFree86. Putting
|
|
2134
|
|
2135 @code{Option "sw_cursor"}
|
|
2136
|
|
2137 in @file{XF86Config} gets rid of the problem.
|
|
2138 @end quotation
|
82
|
2139
|
|
2140 @node Q2.1.12, Q2.1.13, Q2.1.11, Installation
|
274
|
2141 @unnumberedsubsec Q2.1.12: Problems with Regular Expressions on DEC OSF1.
|
82
|
2142
|
|
2143 I have xemacs 19.13 running on an alpha running OSF1 V3.2 148 and ispell
|
|
2144 would not run because it claimed the version number was incorrect
|
|
2145 although it was indeed OK. I traced the problem to the regular
|
|
2146 expression handler.
|
|
2147
|
274
|
2148 @email{douglask@@dstc.edu.au, Douglas Kosovic} writes:
|
82
|
2149
|
|
2150 @quotation
|
282
|
2151 Actually it's a DEC cc optimization bug that screws up the regexp
|
82
|
2152 handling in XEmacs.
|
|
2153
|
|
2154 Rebuilding using the @samp{-migrate} switch for DEC cc (which uses a
|
282
|
2155 different sort of optimization) works fine.
|
82
|
2156 @end quotation
|
|
2157
|
|
2158 See @file{xemacs-19_13-dunix-3_2c.patch} at the following URL on how to
|
|
2159 build with the @samp{-migrate} flag:
|
|
2160
|
|
2161 @example
|
274
|
2162 @uref{http://www-digital.cern.ch/carney/emacs/emacs.html}
|
282
|
2163 @c Link above, <URL:http://www-digital.cern.ch/carney/emacs/emacs.html> is
|
|
2164 @c dead. And the directory `carney' is empty.
|
|
2165
|
|
2166
|
|
2167
|
82
|
2168 @end example
|
|
2169
|
|
2170 NOTE: There have been a variety of other problems reported that are
|
|
2171 fixed in this fashion.
|
|
2172
|
|
2173 @node Q2.1.13, Q2.1.14, Q2.1.12, Installation
|
274
|
2174 @unnumberedsubsec Q2.1.13: HP/UX 10.10 and @code{create_process} failure.
|
|
2175
|
|
2176 @email{Dave.Carrigan@@ipl.ca, Dave Carrigan} writes:
|
82
|
2177
|
|
2178 @quotation
|
|
2179 With XEmacs 19.13 and HP/UX 10.10, anything that relies on the
|
|
2180 @code{create_process} function fails. This breaks a lot of things
|
|
2181 (shell-mode, compile, ange-ftp, to name a few).
|
|
2182 @end quotation
|
|
2183
|
274
|
2184 @email{johnson@@dtc.hp.com, Phil Johnson} writes:
|
82
|
2185
|
|
2186 @quotation
|
|
2187 This is a problem specific to HP-UX 10.10. It only occurs when XEmacs
|
|
2188 is compiled for shared libraries (the default), so you can work around
|
|
2189 it by compiling a statically-linked binary (run configure with
|
|
2190 @samp{--dynamic=no}).
|
|
2191
|
|
2192 I'm not sure whether the problem is with a particular shared library or
|
|
2193 if it's a kernel problem which crept into 10.10.
|
|
2194 @end quotation
|
|
2195
|
274
|
2196 @email{cognot@@ensg.u-nancy.fr, Richard Cognot} writes:
|
82
|
2197
|
|
2198 @quotation
|
|
2199 I had a few problems with 10.10. Apparently, some of them were solved by
|
|
2200 forcing a static link of libc (manually).
|
|
2201 @end quotation
|
|
2202
|
|
2203 @node Q2.1.14, Q2.1.15, Q2.1.13, Installation
|
274
|
2204 @unnumberedsubsec Q2.1.14: @kbd{C-g} doesn't work for me. Is it broken?
|
|
2205
|
|
2206 @email{ben@@666.com, Ben Wing} writes:
|
82
|
2207
|
|
2208 @quotation
|
|
2209 @kbd{C-g} does work for most people in most circumstances. If it
|
|
2210 doesn't, there are only two explanations:
|
|
2211
|
|
2212 @enumerate
|
|
2213 @item
|
|
2214 The code is wrapped with a binding of @code{inhibit-quit} to
|
|
2215 @code{t}. @kbd{Ctrl-Shift-G} should still work, I think.
|
|
2216
|
|
2217 @item
|
|
2218 SIGIO is broken on your system, but BROKEN_SIGIO isn't defined.
|
|
2219 @end enumerate
|
|
2220
|
|
2221 To test #2, try executing @code{(while t)} from the @samp{*scratch*}
|
|
2222 buffer. If @kbd{C-g} doesn't interrupt, then you're seeing #2.
|
|
2223 @end quotation
|
|
2224
|
274
|
2225 @email{terra@@diku.dk, Morten Welinder} writes:
|
82
|
2226
|
|
2227 @quotation
|
|
2228 On some (but @emph{not} all) machines a hung XEmacs can be revived by
|
|
2229 @code{kill -FPE <pid>}. This is a hack, of course, not a solution.
|
|
2230 This technique works on a Sun4 running 4.1.3_U1. To see if it works for
|
|
2231 you, start another XEmacs and test with that first. If you get a core
|
|
2232 dump the method doesn't work and if you get @samp{Arithmetic error} then
|
|
2233 it does.
|
|
2234 @end quotation
|
|
2235
|
|
2236 @node Q2.1.15, Q2.1.16, Q2.1.14, Installation
|
274
|
2237 @unnumberedsubsec Q2.1.15: How to Debug an XEmacs problem with a debugger
|
82
|
2238
|
|
2239 If XEmacs does crash on you, one of the most productive things you can
|
|
2240 do to help get the bug fixed is to poke around a bit with the debugger.
|
|
2241 Here are some hints:
|
|
2242
|
|
2243 @itemize @bullet
|
|
2244 @item
|
|
2245 First of all, if the crash is at all reproducible, consider very
|
|
2246 strongly recompiling your XEmacs with debugging symbols, with no
|
282
|
2247 optimization, and with the configure options @samp{--debug=yes} and
|
|
2248 @samp{--error-checking=all}. This will make your XEmacs run somewhat
|
|
2249 slower but make it a lot more likely to catch the problem earlier
|
|
2250 (closer to its source), and a lot easier to determine what's going on
|
|
2251 with a debugger.
|
82
|
2252
|
|
2253 @item
|
|
2254 If you're able to run XEmacs under a debugger and reproduce the crash
|
|
2255 (if it's inconvenient to do this because XEmacs is already running or is
|
|
2256 running in batch mode as part of a bunch of scripts, consider attaching
|
|
2257 to the existing process with your debugger; most debuggers let you do
|
|
2258 this by substituting the process ID for the core file when you invoke
|
|
2259 the debugger from the command line, or by using the @code{attach}
|
|
2260 command or something similar), here are some things you can do:
|
|
2261
|
|
2262 @item
|
|
2263 If XEmacs is hitting an assertion failure, put a breakpoint on
|
|
2264 @code{assert_failed()}.
|
|
2265
|
|
2266 @item
|
|
2267 If XEmacs is hitting some weird Lisp error that's causing it to crash
|
|
2268 (e.g. during startup), put a breakpoint on @code{signal_1()}---this is
|
|
2269 declared static in eval.c.
|
|
2270
|
|
2271 @item
|
|
2272 Internally, you will probably see lots of variables that hold objects of
|
|
2273 type @code{Lisp_Object}. These are exactly what they appear to be,
|
|
2274 i.e. references to Lisp objects. Printing them out with the debugger
|
282
|
2275 probably won't be too useful---you'll likely just see a number. To
|
|
2276 decode them, do this:
|
82
|
2277
|
|
2278 @example
|
|
2279 call debug_print (OBJECT)
|
|
2280 @end example
|
|
2281
|
|
2282 where @var{OBJECT} is whatever you want to decode (it can be a variable,
|
|
2283 a function call, etc.). This will print out a readable representation
|
|
2284 on the TTY from which the xemacs process was invoked.
|
|
2285
|
|
2286 @item
|
|
2287 If you want to get a Lisp backtrace showing the Lisp call
|
|
2288 stack, do this:
|
|
2289
|
|
2290 @example
|
|
2291 call debug_backtrace ()
|
|
2292 @end example
|
|
2293
|
|
2294 @item
|
272
|
2295 Using @code{debug_print} and @code{debug_backtrace} has two
|
|
2296 disadvantages - it can only be used with a running xemacs process, and
|
|
2297 it cannot display the internal C structure of a Lisp Object. Even if
|
|
2298 all you've got is a core dump, all is not lost.
|
|
2299
|
|
2300 If you're using GDB, there are some macros in the file
|
|
2301 @file{src/gdbinit} in the XEmacs source distribution that should make it
|
|
2302 easier for you to decode Lisp objects. Copy this file to
|
|
2303 @file{~/.gdbinit}, or @code{source} it from @file{~/.gdbinit}, and use
|
|
2304 the macros defined therein. In particular, use the @code{pobj} macro to
|
|
2305 print the internal C representation of a lisp object. This will work
|
|
2306 with a core file or not-yet-run executable. The aliases @code{ldp} and
|
|
2307 @code{lbt} are provided for conveniently calling @code{debug_print} and
|
|
2308 @code{debug_backtrace}.
|
|
2309
|
|
2310 If you are using Sun's @file{dbx} debugger, there is an equivalent file
|
|
2311 @file{src/dbxrc} to copy to or source from @file{~/.dbxrc}.
|
82
|
2312
|
|
2313 @item
|
|
2314 If you're using a debugger to get a C stack backtrace and you're seeing
|
|
2315 stack traces with some of the innermost frames mangled, it may be due to
|
|
2316 dynamic linking. (This happens especially under Linux.) Consider
|
|
2317 reconfiguring with @samp{--dynamic=no}. Also, sometimes (again under
|
|
2318 Linux), stack backtraces of core dumps will have the frame where the
|
|
2319 fatal signal occurred mangled; if you can obtain a stack trace while
|
|
2320 running the XEmacs process under a debugger, the stack trace should be
|
|
2321 clean.
|
|
2322
|
274
|
2323 @email{1CMC3466@@ibm.mtsac.edu, Curtiss} suggests upgrading to ld.so version 1.8
|
82
|
2324 if dynamic linking and debugging is a problem on Linux.
|
|
2325
|
|
2326 @item
|
|
2327 If you're using a debugger to get a C stack backtrace and you're
|
|
2328 getting a completely mangled and bogus stack trace, it's probably due to
|
|
2329 one of the following:
|
|
2330
|
|
2331 @enumerate a
|
|
2332 @item
|
|
2333 Your executable has been stripped. Bad news. Tell your sysadmin not to
|
|
2334 do this---it doesn't accomplish anything except to save a bit of disk
|
|
2335 space, and makes debugging much much harder.
|
|
2336
|
|
2337 @item
|
|
2338 Your stack is getting trashed. Debugging this is hard; you have to do a
|
282
|
2339 binary-search type of narrowing down where the crash occurs, until you
|
82
|
2340 figure out exactly which line is causing the problem. Of course, this
|
|
2341 only works if the bug is highly reproducible.
|
|
2342
|
|
2343 @item
|
|
2344 If your stack trace has exactly one frame in it, with address 0x0, this
|
|
2345 could simply mean that XEmacs attempted to execute code at that address,
|
|
2346 e.g. through jumping to a null function pointer. Unfortunately, under
|
|
2347 those circumstances, GDB under Linux doesn't know how to get a stack
|
|
2348 trace. (Yes, this is the third Linux-related problem I've mentioned. I
|
|
2349 have no idea why GDB under Linux is so bogus. Complain to the GDB
|
|
2350 authors, or to comp.os.linux.development.system). Again, you'll have to
|
|
2351 use the narrowing-down process described above.
|
|
2352
|
|
2353 @item
|
163
|
2354 If you compiled 19.14 with @samp{--debug} (or by default in later
|
|
2355 versions), you will get a Lisp backtrace output when XEmacs crashes, so
|
282
|
2356 you'll have something useful.
|
274
|
2357
|
82
|
2358 @end enumerate
|
272
|
2359
|
282
|
2360 @item
|
|
2361 If you compile with the newer gcc variants gcc-2.8 or egcs, you will
|
|
2362 also need gdb 4.17. Earlier releases of gdb can't handle the debug
|
|
2363 information generated by the newer compilers.
|
|
2364
|
|
2365 @item
|
|
2366 The above information on using @file{src/gdbinit} works for XEmacs-21.0
|
|
2367 and above. For older versions of XEmacs, there are different
|
|
2368 @file{gdbinit} files provided in the @file{src} directory. Use the one
|
|
2369 corresponding to the configure options used when building XEmacs.
|
|
2370
|
82
|
2371 @end itemize
|
|
2372
|
|
2373 @node Q2.1.16, Q2.1.17, Q2.1.15, Installation
|
274
|
2374 @unnumberedsubsec Q2.1.16: XEmacs crashes in @code{strcat} on HP/UX 10
|
82
|
2375
|
|
2376 >From the problems database (through
|
274
|
2377 @uref{http://support.mayfield.hp.com/}):
|
54
|
2378
|
|
2379 @example
|
82
|
2380 Problem Report: 5003302299
|
|
2381 Status: Open
|
|
2382
|
|
2383 System/Model: 9000/700
|
|
2384 Product Name: HPUX S800 10.0X
|
|
2385 Product Vers: 9245XB.10.00
|
|
2386
|
274
|
2387 Description: strcat(3C) may read beyond
|
|
2388 end of source string, can cause SIGSEGV
|
82
|
2389
|
|
2390
|
|
2391 *** PROBLEM TEXT ***
|
|
2392 strcat(3C) may read beyond the source string onto an unmapped page,
|
|
2393 causing a segmentation violation.
|
|
2394 @end example
|
|
2395
|
|
2396 @node Q2.1.17, Q2.1.18, Q2.1.16, Installation
|
274
|
2397 @unnumberedsubsec Q2.1.17: @samp{Marker does not point anywhere}
|
82
|
2398
|
163
|
2399 As with other errors, set @code{debug-on-error} to @code{t} to get the
|
|
2400 backtrace when the error occurs. Specifically, two problems have been
|
|
2401 reported (and fixed).
|
|
2402
|
|
2403 @enumerate
|
|
2404 @item
|
|
2405 A problem with line-number-mode in XEmacs 19.14 affected a large number
|
|
2406 of other packages. If you see this error message, turn off
|
82
|
2407 line-number-mode.
|
|
2408
|
163
|
2409 @item
|
|
2410 A problem with some early versions of Gnus 5.4 caused this error.
|
|
2411 Upgrade your Gnus.
|
|
2412 @end enumerate
|
|
2413
|
82
|
2414 @node Q2.1.18, Q2.1.19, Q2.1.17, Installation
|
274
|
2415 @unnumberedsubsec Q2.1.18: 19.14 hangs on HP/UX 10.10.
|
|
2416
|
|
2417 @email{cognot@@ensg.u-nancy.fr, Richard Cognot} writes:
|
82
|
2418
|
|
2419 @quotation
|
|
2420 For the record, compiling on hpux 10.10 leads to a hang in Gnus when
|
|
2421 compiled with optimization on.
|
|
2422
|
|
2423 I've just discovered that my hpux 10.01 binary was working less well
|
|
2424 than expected. In fact, on a 10.10 system, @code{(while t)} was not
|
217
|
2425 interrupted by @kbd{C-g}. I defined @code{BROKEN_SIGIO} and recompiled on
|
82
|
2426 10.10, and... the hang is now gone.
|
|
2427
|
|
2428 As far as configure goes, this will be a bit tricky: @code{BROKEN_SIGIO}
|
|
2429 is needed on 10.10, but @strong{not} on 10.01: if I run my 10.01 binary
|
|
2430 on a 10.01 machine, without @code{BROKEN_SIGIO} being defined, @kbd{C-g}
|
|
2431 works as expected.
|
|
2432 @end quotation
|
|
2433
|
274
|
2434 @email{cognot@@ensg.u-nancy.fr, Richard Cognot} adds:
|
82
|
2435
|
|
2436 @quotation
|
282
|
2437 Apparently somebody has found the reason why there is this
|
274
|
2438 @iftex
|
|
2439 @*
|
282
|
2440 @end iftex
|
274
|
2441 @samp{poll:
|
82
|
2442 interrupted...} message for each event. For some reason, libcurses
|
|
2443 reimplements a @code{select()} system call, in a highly broken fashion.
|
|
2444 The fix is to add a -lc to the link line @emph{before} the
|
|
2445 -lxcurses. XEmacs will then use the right version of @code{select()}.
|
|
2446 @end quotation
|
|
2447
|
|
2448
|
274
|
2449 @email{af@@biomath.jussieu.fr, Alain Fauconnet} writes:
|
82
|
2450
|
|
2451 @quotation
|
|
2452 The @emph{real} solution is to @emph{not} link -lcurses in! I just
|
|
2453 changed -lcurses to -ltermcap in the Makefile and it fixed:
|
|
2454
|
|
2455 @enumerate
|
|
2456 @item
|
|
2457 The @samp{poll: interrupted system call} message.
|
|
2458
|
|
2459 @item
|
|
2460 A more serious problem I had discovered in the meantime, that is the
|
|
2461 fact that subprocess handling was seriously broken: subprocesses
|
163
|
2462 e.g. started by AUC TeX for TeX compilation of a buffer would
|
82
|
2463 @emph{hang}. Actually they would wait forever for emacs to read the
|
|
2464 socket which connects stdout...
|
|
2465 @end enumerate
|
|
2466 @end quotation
|
|
2467
|
|
2468 @node Q2.1.19, Q2.1.20, Q2.1.18, Installation
|
274
|
2469 @unnumberedsubsec Q2.1.19: XEmacs does not follow the local timezone.
|
82
|
2470
|
|
2471 When using one of the prebuilt binaries many users have observed that
|
|
2472 XEmacs uses the timezone under which it was built, but not the timezone
|
|
2473 under which it is running. The solution is to add:
|
|
2474
|
|
2475 @lisp
|
|
2476 (set-time-zone-rule "MET")
|
|
2477 @end lisp
|
|
2478
|
|
2479 to your @file{.emacs} or the @file{site-start.el} file if you can.
|
|
2480 Replace @code{MET} with your local timezone.
|
|
2481
|
|
2482 @node Q2.1.20, Q2.1.21, Q2.1.19, Installation
|
274
|
2483 @unnumberedsubsec Q2.1.20: @samp{Symbol's function definition is void: hkey-help-show.}
|
82
|
2484
|
|
2485 This is a problem with a partially loaded hyperbole. Try adding:
|
|
2486
|
|
2487 @lisp
|
|
2488 (require 'hmouse-drv)
|
|
2489 @end lisp
|
|
2490
|
|
2491 where you load hyperbole and the problem should go away.
|
|
2492
|
116
|
2493 @node Q2.1.21, Q2.1.22, Q2.1.20, Installation
|
274
|
2494 @unnumberedsubsec Q2.1.21: Every so often the XEmacs frame freezes
|
82
|
2495
|
|
2496 This problem has been fixed in 19.15, and was due to a not easily
|
|
2497 reproducible race condition.
|
|
2498
|
126
|
2499 @node Q2.1.22, Q2.1.23, Q2.1.21, Installation
|
274
|
2500 @unnumberedsubsec Q2.1.22: XEmacs seems to take a really long time to do some things
|
|
2501
|
|
2502 @email{dmoore@@ucsd.edu, David Moore} writes:
|
116
|
2503
|
|
2504 @quotation
|
|
2505 Two things you can do:
|
|
2506
|
|
2507 1) C level:
|
|
2508
|
|
2509 When you see it going mad like this, you might want to use gdb from an
|
|
2510 'xterm' to attach to the running process and get a stack trace. To do
|
|
2511 this just run:
|
|
2512
|
|
2513 @example
|
|
2514 gdb /path/to/xemacs/xemacs ####
|
|
2515 @end example
|
|
2516
|
163
|
2517 Where @code{####} is the process id of your xemacs, instead of
|
|
2518 specifying the core. When gdb attaches, the xemacs will stop [1] and
|
|
2519 you can type `where' in gdb to get a stack trace as usual. To get
|
|
2520 things moving again, you can just type `quit' in gdb. It'll tell you
|
|
2521 the program is running and ask if you want to quit anyways. Say 'y' and
|
|
2522 it'll quit and have your emacs continue from where it was at.
|
116
|
2523
|
|
2524 2) Lisp level:
|
|
2525
|
|
2526 Turn on debug-on-quit early on. When you think things are going slow
|
|
2527 hit C-g and it may pop you in the debugger so you can see what routine
|
|
2528 is running. Press `c' to get going again.
|
|
2529
|
|
2530 debug-on-quit doesn't work if something's turned on inhibit-quit or in
|
|
2531 some other strange cases.
|
|
2532 @end quotation
|
|
2533
|
126
|
2534 @node Q2.1.23, , Q2.1.22, Installation
|
282
|
2535 @unnumberedsubsec Q2.1.23: Movemail on Linux does not work for XEmacs 19.15 and later.
|
126
|
2536
|
|
2537 Movemail used to work fine in 19.14 but has stopped working in 19.15
|
|
2538 and 20.x. I am using Linux.
|
|
2539
|
274
|
2540 @email{steve@@xemacs.org, SL Baur} writes:
|
126
|
2541
|
|
2542 @quotation
|
163
|
2543 Movemail on Linux used to default to using flock file locking. With
|
|
2544 19.15 and later versions it now defaults to using @code{.lock} file
|
|
2545 locking. If this is not appropriate for your system, edit src/s/linux.h
|
|
2546 and uncomment the line that reads:
|
|
2547
|
|
2548 @example
|
|
2549 #define MAIL_USE_FLOCK
|
|
2550 @end example
|
126
|
2551 @end quotation
|
|
2552
|
82
|
2553 @node Customization, Subsystems, Installation, Top
|
274
|
2554 @unnumbered 3 Customization and Options
|
82
|
2555
|
|
2556 This is part 3 of the XEmacs Frequently Asked Questions list. This
|
|
2557 section is devoted to Customization and screen settings.
|
|
2558
|
|
2559 @menu
|
|
2560 Customization---Emacs Lisp and @file{.emacs}:
|
282
|
2561 * Q3.0.1:: What version of Emacs am I running?
|
82
|
2562 * Q3.0.2:: How do I evaluate Elisp expressions?
|
|
2563 * Q3.0.3:: @code{(setq tab-width 6)} behaves oddly.
|
|
2564 * Q3.0.4:: How can I add directories to the @code{load-path}?
|
|
2565 * Q3.0.5:: How to check if a lisp function is defined?
|
|
2566 * Q3.0.6:: Can I force the output of @code{(face-list)} to a buffer?
|
282
|
2567 * Q3.0.7:: Font selections don't get saved after @code{Save Options}.
|
82
|
2568 * Q3.0.8:: How do I make a single minibuffer frame?
|
217
|
2569 * Q3.0.9:: What is @code{Customize}?
|
82
|
2570
|
|
2571 X Window System & Resources:
|
|
2572 * Q3.1.1:: Where is a list of X resources?
|
|
2573 * Q3.1.2:: How can I detect a color display?
|
|
2574 * Q3.1.3:: @code{(set-screen-width)} worked in 19.6, but not in 19.13?
|
217
|
2575 * Q3.1.4:: Specifying @code{Emacs*EmacsScreen.geometry} in @file{.emacs} does not work in 19.15?
|
82
|
2576 * Q3.1.5:: How can I get the icon to just say @samp{XEmacs}?
|
|
2577 * Q3.1.6:: How can I have the window title area display the full path?
|
|
2578 * Q3.1.7:: @samp{xemacs -name junk} doesn't work?
|
282
|
2579 * Q3.1.8:: @samp{-iconic} doesn't work.
|
82
|
2580
|
|
2581 Textual Fonts & Colors:
|
|
2582 * Q3.2.1:: How can I set color options from @file{.emacs}?
|
|
2583 * Q3.2.2:: How do I set the text, menu and modeline fonts?
|
|
2584 * Q3.2.3:: How can I set the colors when highlighting a region?
|
282
|
2585 * Q3.2.4:: How can I limit color map usage?
|
82
|
2586 * Q3.2.5:: My tty supports color, but XEmacs doesn't use them.
|
282
|
2587 * Q3.2.6:: Can I have pixmap backgrounds in XEmacs?
|
82
|
2588
|
|
2589 The Modeline:
|
|
2590 * Q3.3.1:: How can I make the modeline go away?
|
|
2591 * Q3.3.2:: How do you have XEmacs display the line number in the modeline?
|
|
2592 * Q3.3.3:: How do I get XEmacs to put the time of day on the modeline?
|
163
|
2593 * Q3.3.4:: How do I turn off current chapter from AUC TeX modeline?
|
|
2594 * Q3.3.5:: How can one change the modeline color based on the mode used?
|
82
|
2595
|
|
2596 3.4 Multiple Device Support:
|
282
|
2597 * Q3.4.1:: How do I open a frame on another screen of my multi-headed display?
|
82
|
2598 * Q3.4.2:: Can I really connect to a running XEmacs after calling up over a modem? How?
|
|
2599
|
|
2600 3.5 The Keyboard:
|
|
2601 * Q3.5.1:: How can I bind complex functions (or macros) to keys?
|
|
2602 * Q3.5.2:: How can I stop down-arrow from adding empty lines to the bottom of my buffers?
|
|
2603 * Q3.5.3:: How do I bind C-. and C-; to scroll one line up and down?
|
|
2604 * Q3.5.4:: Globally binding @kbd{Delete}?
|
|
2605 * Q3.5.5:: Scrolling one line at a time.
|
282
|
2606 * Q3.5.6:: How to map @kbd{Help} key alone on Sun type4 keyboard?
|
82
|
2607 * Q3.5.7:: How can you type in special characters in XEmacs?
|
|
2608 * Q3.5.8:: Why does @code{(global-set-key [delete-forward] 'delete-char)} complain?
|
|
2609 * Q3.5.9:: How do I make the Delete key delete forward?
|
|
2610 * Q3.5.10:: Can I turn on @dfn{sticky} modifier keys?
|
282
|
2611 * Q3.5.11:: How do I map the arrow keys?
|
82
|
2612
|
|
2613 The Cursor:
|
|
2614 * Q3.6.1:: Is there a way to make the bar cursor thicker?
|
|
2615 * Q3.6.2:: Is there a way to get back the old block cursor where the cursor covers the character in front of the point?
|
|
2616 * Q3.6.3:: Can I make the cursor blink?
|
|
2617
|
|
2618 The Mouse and Highlighting:
|
|
2619 * Q3.7.1:: How can I turn off Mouse pasting?
|
|
2620 * Q3.7.2:: How do I set control/meta/etc modifiers on mouse buttons?
|
|
2621 * Q3.7.3:: Clicking the left button does not do anything in buffer list.
|
|
2622 * Q3.7.4:: How can I get a list of buffers when I hit mouse button 3?
|
|
2623 * Q3.7.5:: Why does cut-and-paste not work between XEmacs and a cmdtool?
|
|
2624 * Q3.7.6:: How I can set XEmacs up so that it pastes where the text cursor is?
|
|
2625 * Q3.7.7:: How do I select a rectangular region?
|
|
2626 * Q3.7.8:: Why does @kbd{M-w} take so long?
|
|
2627
|
|
2628 The Menubar and Toolbar:
|
|
2629 * Q3.8.1:: How do I get rid of the menu (or menubar)?
|
|
2630 * Q3.8.2:: Can I customize the basic menubar?
|
|
2631 * Q3.8.3:: How do I control how many buffers are listed in the menu @code{Buffers} list?
|
|
2632 * Q3.8.4:: Resources like @code{Emacs*menubar*font} are not working?
|
|
2633 * Q3.8.5:: How can I bind a key to a function to toggle the toolbar?
|
|
2634
|
|
2635 Scrollbars:
|
|
2636 * Q3.9.1:: How can I disable the scrollbar?
|
|
2637 * Q3.9.2:: How can one use resources to change scrollbar colors?
|
|
2638 * Q3.9.3:: Moving the scrollbar can move the point; can I disable this?
|
|
2639 * Q3.9.4:: How can I get automatic horizontal scrolling?
|
|
2640
|
|
2641 Text Selections:
|
282
|
2642 * Q3.10.1:: How can I turn off or change highlighted selections?
|
82
|
2643 * Q3.10.2:: How do I get that typing on an active region removes it?
|
|
2644 * Q3.10.3:: Can I turn off the highlight during isearch?
|
|
2645 * Q3.10.4:: How do I turn off highlighting after @kbd{C-x C-p} (mark-page)?
|
|
2646 * Q3.10.5:: The region disappears when I hit the end of buffer while scrolling.
|
|
2647 @end menu
|
|
2648
|
|
2649 @node Q3.0.1, Q3.0.2, Customization, Customization
|
274
|
2650 @unnumberedsec 3.0: Customization -- Emacs Lisp and .emacs
|
|
2651 @unnumberedsubsec Q3.0.1: What version of Emacs am I running?
|
82
|
2652
|
|
2653 How can @file{.emacs} determine which of the family of Emacsen I am
|
|
2654 using?
|
|
2655
|
|
2656 To determine if you are currently running GNU Emacs 18, GNU Emacs 19,
|
126
|
2657 XEmacs 19, XEmacs 20, or Epoch, and use appropriate code, check out the
|
|
2658 example given in @file{etc/sample.emacs}. There are other nifty things
|
|
2659 in there as well!
|
82
|
2660
|
|
2661 For all new code, all you really need to do is:
|
|
2662
|
|
2663 @lisp
|
|
2664 (defvar running-xemacs (string-match "XEmacs\\|Lucid" emacs-version))
|
|
2665 @end lisp
|
|
2666
|
|
2667 @node Q3.0.2, Q3.0.3, Q3.0.1, Customization
|
274
|
2668 @unnumberedsubsec Q3.0.2: How can I evaluate Emacs-Lisp expressions?
|
82
|
2669
|
|
2670 I know I can evaluate Elisp expressions from @code{*scratch*} buffer
|
|
2671 with @kbd{C-j} after the expression. How do I do it from another
|
|
2672 buffer?
|
|
2673
|
163
|
2674 Press @kbd{M-:} (the default binding of @code{eval-expression}), and
|
|
2675 enter the expression to the minibuffer. In XEmacs prior to 19.15
|
|
2676 @code{eval-expression} used to be a disabled command by default. If
|
|
2677 this is the case, upgrade your XEmacs.
|
82
|
2678
|
|
2679 @node Q3.0.3, Q3.0.4, Q3.0.2, Customization
|
274
|
2680 @unnumberedsubsec Q3.0.3: @code{(setq tab-width 6)} behaves oddly.
|
82
|
2681
|
|
2682 If you put @code{(setq tab-width 6)} in your @file{.emacs} file it does
|
|
2683 not work! Is there a reason for this? If you do it at the EVAL prompt
|
|
2684 it works fine!! How strange.
|
|
2685
|
|
2686 Use @code{setq-default} instead, since @code{tab-width} is
|
|
2687 all-buffer-local.
|
|
2688
|
|
2689 @node Q3.0.4, Q3.0.5, Q3.0.3, Customization
|
274
|
2690 @unnumberedsubsec Q3.0.4: How can I add directories to the @code{load-path}?
|
82
|
2691
|
|
2692 Here are two ways to do that, one that puts your directories at the
|
|
2693 front of the load-path, the other at the end:
|
|
2694
|
|
2695 @lisp
|
|
2696 ;;; Add things at the beginning of the load-path, do not add
|
|
2697 ;;; duplicate directories:
|
163
|
2698 (pushnew "bar" load-path :test 'equal)
|
|
2699
|
|
2700 (pushnew "foo" load-path :test 'equal)
|
82
|
2701
|
|
2702 ;;; Add things at the end, unconditionally
|
163
|
2703 (setq load-path (nconc load-path '("foo" "bar")))
|
82
|
2704 @end lisp
|
|
2705
|
274
|
2706 @email{keithh@@nortel.ca, keith (k.p.) hanlan} writes:
|
82
|
2707
|
|
2708 @quotation
|
|
2709 To add directories using Unix shell metacharacters use
|
|
2710 @file{expand-file-name} like this:
|
|
2711
|
|
2712 @lisp
|
163
|
2713 (push (expand-file-name "~keithh/.emacsdir") load-path)
|
82
|
2714 @end lisp
|
|
2715 @end quotation
|
|
2716
|
|
2717 @node Q3.0.5, Q3.0.6, Q3.0.4, Customization
|
274
|
2718 @unnumberedsubsec Q3.0.5: How to check if a lisp function is defined?
|
82
|
2719
|
|
2720 Use the following elisp:
|
|
2721
|
|
2722 @lisp
|
|
2723 (fboundp 'foo)
|
|
2724 @end lisp
|
|
2725
|
|
2726 It's almost always a mistake to test @code{emacs-version} or any similar
|
|
2727 variables.
|
|
2728
|
|
2729 Instead, use feature-tests, such as @code{featurep}, @code{boundp},
|
274
|
2730 @code{fboundp}, or even simple behavioural tests, eg.:
|
82
|
2731
|
|
2732 @lisp
|
282
|
2733 (defvar foo-old-losing-code-p
|
82
|
2734 (condition-case nil (progn (losing-code t) nil)
|
274
|
2735 (wrong-number-of-arguments t)))
|
82
|
2736 @end lisp
|
|
2737
|
|
2738 There is an incredible amount of broken code out there which could work
|
|
2739 much better more often in more places if it did the above instead of
|
|
2740 trying to divine its environment from the value of one variable.
|
|
2741
|
|
2742 @node Q3.0.6, Q3.0.7, Q3.0.5, Customization
|
274
|
2743 @unnumberedsubsec Q3.0.6: Can I force the output of @code{(face-list)} to a buffer?
|
82
|
2744
|
|
2745 It would be good having it in a buffer, as the output of
|
|
2746 @code{(face-list)} is too wide to fit to a minibuffer.
|
|
2747
|
|
2748 Evaluate the expression in the @samp{*scratch*} buffer with point after
|
|
2749 the rightmost paren and typing @kbd{C-j}.
|
|
2750
|
163
|
2751 If the minibuffer smallness is the only problem you encounter, you can
|
|
2752 simply press @kbd{C-h l} to get the former minibuffer contents in a
|
|
2753 buffer.
|
|
2754
|
82
|
2755 @node Q3.0.7, Q3.0.8, Q3.0.6, Customization
|
274
|
2756 @unnumberedsubsec Q3.0.7: Font selections in don't get saved after @code{Save Options}.
|
126
|
2757
|
|
2758 For XEmacs 19.14 and previous:
|
82
|
2759
|
274
|
2760 @email{mannj@@ll.mit.edu, John Mann} writes:
|
82
|
2761
|
|
2762 @quotation
|
|
2763 You have to go to Options->Menubar Appearance and unselect
|
|
2764 @samp{Frame-Local Font Menu}. If this option is selected, font changes
|
|
2765 are only applied to the @emph{current} frame and do @emph{not} get saved
|
|
2766 when you save options.
|
|
2767 @end quotation
|
|
2768
|
126
|
2769 For XEmacs 19.15 and later:
|
|
2770
|
282
|
2771 Implement the above as well as set the following in your @file{.emacs}
|
126
|
2772
|
|
2773 @lisp
|
163
|
2774 (setq options-save-faces t)
|
126
|
2775 @end lisp
|
|
2776
|
215
|
2777 @node Q3.0.8, Q3.0.9, Q3.0.7, Customization
|
274
|
2778 @unnumberedsubsec Q3.0.8: How do I get a single minibuffer frame?
|
|
2779
|
|
2780 @email{acs@@acm.org, Vin Shelton} writes:
|
82
|
2781
|
|
2782 @lisp
|
|
2783 (setq initial-frame-plist '(minibuffer nil))
|
|
2784 (setq default-frame-plist '(minibuffer nil))
|
|
2785 (setq default-minibuffer-frame
|
|
2786 (make-frame
|
274
|
2787 '(minibuffer only
|
|
2788 width 86
|
|
2789 height 1
|
|
2790 menubar-visible-p nil
|
|
2791 default-toolbar-visible-p nil
|
|
2792 name "minibuffer"
|
|
2793 top -2
|
|
2794 left -2
|
|
2795 has-modeline-p nil)))
|
82
|
2796 (frame-notice-user-settings)
|
|
2797 @end lisp
|
|
2798
|
298
|
2799 @strong{Please note:} The single minibuffer frame may not be to everyone's
|
82
|
2800 taste, and there any number of other XEmacs options settings that may
|
|
2801 make it difficult or inconvenient to use.
|
|
2802
|
215
|
2803 @node Q3.0.9, Q3.1.1, Q3.0.8, Customization
|
274
|
2804 @unnumberedsubsec Q3.0.9: What is @code{Customize}?
|
217
|
2805
|
|
2806 Starting with XEmacs 20.2 there is new system 'Customize' for customizing
|
215
|
2807 XEmacs options.
|
|
2808
|
|
2809 You can access @code{Customize} from the @code{Options} menu
|
217
|
2810 or invoking one of customize commands by typing eg.
|
215
|
2811 @kbd{M-x customize}, @kbd{M-x customize-face},
|
|
2812 @kbd{M-x customize-variable} or @kbd{M-x customize-apropos}.
|
|
2813
|
217
|
2814 Starting with XEmacs 20.3 there is also new `browser' mode for Customize.
|
215
|
2815 Try it out with @kbd{M-x customize-browse}
|
|
2816
|
|
2817 @node Q3.1.1, Q3.1.2, Q3.0.9, Customization
|
274
|
2818 @unnumberedsec 3.1: X Window System & Resources
|
|
2819 @unnumberedsubsec Q3.1.1: Where is a list of X resources?
|
82
|
2820
|
|
2821 Search through the @file{NEWS} file for @samp{X Resources}. A fairly
|
|
2822 comprehensive list is given after it.
|
|
2823
|
|
2824 In addition, an @file{app-defaults} file is supplied,
|
|
2825 @file{etc/Emacs.ad} listing the defaults. The file
|
|
2826 @file{etc/sample.Xdefaults} gives a set of defaults that you might
|
|
2827 consider. It is essentially the same as @file{etc/Emacs.ad} but some
|
|
2828 entries are slightly altered. Be careful about installing the contents
|
|
2829 of this file into your @file{.Xdefaults} or @file{.Xresources} file if
|
|
2830 you use GNU Emacs under X11 as well.
|
|
2831
|
|
2832 @node Q3.1.2, Q3.1.3, Q3.1.1, Customization
|
274
|
2833 @unnumberedsubsec Q3.1.2: How can I detect a color display?
|
82
|
2834
|
|
2835 You can test the return value of the function @code{(device-class)}, as
|
|
2836 in:
|
|
2837
|
|
2838 @lisp
|
|
2839 (when (eq (device-class) 'color)
|
|
2840 (set-face-foreground 'font-lock-comment-face "Grey")
|
|
2841 (set-face-foreground 'font-lock-string-face "Red")
|
|
2842 ....
|
|
2843 )
|
|
2844 @end lisp
|
|
2845
|
|
2846 @node Q3.1.3, Q3.1.4, Q3.1.2, Customization
|
274
|
2847 @unnumberedsubsec Q3.1.3: @code{(set-screen-width)} worked in 19.6, but not in 19.13?
|
82
|
2848
|
|
2849 In Lucid Emacs 19.6 I did @code{(set-screen-width @var{characters})} and
|
|
2850 @code{(set-screen-height @var{lines})} in my @file{.emacs} instead of
|
282
|
2851 specifying @code{Emacs*EmacsScreen.geometry} in my
|
274
|
2852 @iftex
|
|
2853 @*
|
282
|
2854 @end iftex
|
274
|
2855 @file{.Xdefaults} but
|
82
|
2856 this does not work in XEmacs 19.13.
|
|
2857
|
|
2858 These two functions now take frame arguments:
|
|
2859
|
|
2860 @lisp
|
|
2861 (set-frame-width (selected-frame) @var{characters})
|
|
2862 (set-frame-height (selected-frame) @var{lines})
|
|
2863 @end lisp
|
|
2864
|
|
2865 @node Q3.1.4, Q3.1.5, Q3.1.3, Customization
|
274
|
2866 @unnumberedsubsec Q3.1.4: Specifying @code{Emacs*EmacsScreen.geometry} in @file{.emacs} does not work in 19.15?
|
82
|
2867
|
|
2868 In XEmacs 19.11 I specified @code{Emacs*EmacsScreen.geometry} in
|
126
|
2869 my @file{.emacs} but this does not work in XEmacs 19.15.
|
82
|
2870
|
|
2871 We have switched from using the term @dfn{screen} to using the term
|
|
2872 @dfn{frame}.
|
|
2873
|
|
2874 The correct entry for your @file{.Xdefaults} is now:
|
|
2875
|
|
2876 @example
|
|
2877 Emacs*EmacsFrame.geometry
|
|
2878 @end example
|
|
2879
|
|
2880 @node Q3.1.5, Q3.1.6, Q3.1.4, Customization
|
274
|
2881 @unnumberedsubsec Q3.1.5: How can I get the icon to just say @samp{XEmacs}?
|
82
|
2882
|
|
2883 I'd like the icon to just say @samp{XEmacs}, and not include the name of
|
|
2884 the current file in it.
|
|
2885
|
|
2886 Add the following line to your @file{.emacs}:
|
|
2887
|
|
2888 @lisp
|
|
2889 (setq frame-icon-title-format "XEmacs")
|
|
2890 @end lisp
|
|
2891
|
|
2892 @node Q3.1.6, Q3.1.7, Q3.1.5, Customization
|
274
|
2893 @unnumberedsubsec Q3.1.6: How can I have the window title area display the full path?
|
82
|
2894
|
|
2895 I'd like to have the window title area display the full directory/name
|
|
2896 of the current buffer file and not just the name.
|
|
2897
|
|
2898 Add the following line to your @file{.emacs}:
|
|
2899
|
|
2900 @lisp
|
|
2901 (setq frame-title-format "%S: %f")
|
|
2902 @end lisp
|
|
2903
|
|
2904 A more sophisticated title might be:
|
|
2905
|
|
2906 @lisp
|
|
2907 (setq frame-title-format
|
282
|
2908 '("%S: " (buffer-file-name "%f"
|
274
|
2909 (dired-directory dired-directory "%b"))))
|
82
|
2910 @end lisp
|
|
2911
|
|
2912 That is, use the file name, or the dired-directory, or the buffer name.
|
|
2913
|
|
2914 @node Q3.1.7, Q3.1.8, Q3.1.6, Customization
|
274
|
2915 @unnumberedsubsec Q3.1.7: @samp{xemacs -name junk} doesn't work?
|
82
|
2916
|
|
2917 When I run @samp{xterm -name junk}, I get an xterm whose class name
|
|
2918 according to xprop, is @samp{junk}. This is the way it's supposed to
|
|
2919 work, I think. When I run @samp{xemacs -name junk} the class name is
|
|
2920 not set to @samp{junk}. It's still @samp{emacs}. What does
|
|
2921 @samp{xemacs -name} really do? The reason I ask is that my window
|
|
2922 manager (fvwm) will make a window sticky and I use XEmacs to read my
|
|
2923 mail. I want that XEmacs window to be sticky, without having to use the
|
|
2924 window manager's function to set the window sticky. What gives?
|
|
2925
|
|
2926 @samp{xemacs -name} sets the application name for the program (that is,
|
|
2927 the thing which normally comes from @samp{argv[0]}). Using @samp{-name}
|
|
2928 is the same as making a copy of the executable with that new name. The
|
|
2929 @code{WM_CLASS} property on each frame is set to the frame-name, and the
|
|
2930 application-class. So, if you did @samp{xemacs -name FOO} and then
|
|
2931 created a frame named @var{BAR}, you'd get an X window with WM_CLASS =
|
|
2932 @code{( "BAR", "Emacs")}. However, the resource hierarchy for this
|
|
2933 widget would be:
|
|
2934
|
|
2935 @example
|
|
2936 Name: FOO .shell .container .BAR
|
|
2937 Class: Emacs .TopLevelEmacsShell.EmacsManager.EmacsFrame
|
|
2938 @end example
|
|
2939
|
|
2940 instead of the default
|
|
2941
|
|
2942 @example
|
|
2943 Name: xemacs.shell .container .emacs
|
|
2944 Class: Emacs .TopLevelEmacsShell.EmacsManager.EmacsFrame
|
|
2945 @end example
|
|
2946
|
|
2947
|
|
2948 It is arguable that the first element of WM_CLASS should be set to the
|
|
2949 application-name instead of the frame-name, but I think that's less
|
|
2950 flexible, since it does not give you the ability to have multiple frames
|
|
2951 with different WM_CLASS properties. Another possibility would be for
|
|
2952 the default frame name to come from the application name instead of
|
|
2953 simply being @samp{emacs}. However, at this point, making that change
|
|
2954 would be troublesome: it would mean that many users would have to make
|
|
2955 yet another change to their resource files (since the default frame name
|
|
2956 would suddenly change from @samp{emacs} to @samp{xemacs}, or whatever
|
|
2957 the executable happened to be named), so we'd rather avoid it.
|
|
2958
|
|
2959 To make a frame with a particular name use:
|
|
2960
|
|
2961 @lisp
|
|
2962 (make-frame '((name . "the-name")))
|
|
2963 @end lisp
|
|
2964
|
|
2965 @node Q3.1.8, Q3.2.1, Q3.1.7, Customization
|
274
|
2966 @unnumberedsubsec Q3.1.8: @samp{-iconic} doesn't work.
|
82
|
2967
|
|
2968 When I start up XEmacs using @samp{-iconic} it doesn't work right.
|
|
2969 Using @samp{-unmapped} on the command line, and setting the
|
|
2970 @code{initiallyUnmapped} X Resource don't seem to help much either...
|
|
2971
|
274
|
2972 @email{ben@@666.com, Ben Wing} writes:
|
82
|
2973
|
|
2974 @quotation
|
|
2975 Ugh, this stuff is such an incredible mess that I've about given up
|
|
2976 getting it to work. The principal problem is numerous window-manager
|
|
2977 bugs...
|
|
2978 @end quotation
|
|
2979
|
|
2980 @node Q3.2.1, Q3.2.2, Q3.1.8, Customization
|
274
|
2981 @unnumberedsec 3.2: Textual Fonts & Colors
|
|
2982 @unnumberedsubsec Q3.2.1: How can I set color options from @file{.emacs}?
|
82
|
2983
|
|
2984 How can I set the most commonly used color options from my @file{.emacs}
|
|
2985 instead of from my @file{.Xdefaults}?
|
|
2986
|
|
2987 Like this:
|
|
2988
|
|
2989 @lisp
|
274
|
2990 (set-face-background 'default "bisque") ; frame background
|
|
2991 (set-face-foreground 'default "black") ; normal text
|
|
2992 (set-face-background 'zmacs-region "red") ; When selecting w/
|
282
|
2993 ; mouse
|
82
|
2994 (set-face-foreground 'zmacs-region "yellow")
|
|
2995 (set-face-font 'default "*courier-bold-r*120-100-100*")
|
274
|
2996 (set-face-background 'highlight "blue") ; Ie when selecting
|
|
2997 ; buffers
|
82
|
2998 (set-face-foreground 'highlight "yellow")
|
282
|
2999 (set-face-background 'modeline "blue") ; Line at bottom
|
274
|
3000 ; of buffer
|
82
|
3001 (set-face-foreground 'modeline "white")
|
|
3002 (set-face-font 'modeline "*bold-r-normal*140-100-100*")
|
282
|
3003 (set-face-background 'isearch "yellow") ; When highlighting
|
|
3004 ; while searching
|
82
|
3005 (set-face-foreground 'isearch "red")
|
274
|
3006 (setq x-pointer-foreground-color "black") ; Adds to bg color,
|
|
3007 ; so keep black
|
282
|
3008 (setq x-pointer-background-color "blue") ; This is color
|
274
|
3009 ; you really
|
|
3010 ; want ptr/crsr
|
82
|
3011 @end lisp
|
|
3012
|
|
3013 @node Q3.2.2, Q3.2.3, Q3.2.1, Customization
|
274
|
3014 @unnumberedsubsec Q3.2.2: How do I set the text, menu and modeline fonts?
|
82
|
3015
|
|
3016 Note that you should use @samp{Emacs.} and not @samp{Emacs*} when
|
|
3017 setting face values.
|
|
3018
|
|
3019 In @file{.Xdefaults}:
|
|
3020
|
|
3021 @example
|
282
|
3022 Emacs.default.attributeFont: -*-*-medium-r-*-*-*-120-*-*-m-*-*-*
|
82
|
3023 Emacs*menubar*font: fixed
|
|
3024 Emacs.modeline.attributeFont: fixed
|
|
3025 @end example
|
|
3026
|
|
3027 This is confusing because modeline is a face, and can be found listed
|
|
3028 with all faces in the current mode by using @kbd{M-x set-face-font
|
|
3029 (enter) ?}. It uses the face specification of @code{attributeFont},
|
|
3030 while menubar is a normal X thing that uses the specification
|
|
3031 @code{font}. With Motif it may be necessary to use @code{fontList}
|
|
3032 instead of @code{font}.
|
|
3033
|
|
3034 @node Q3.2.3, Q3.2.4, Q3.2.2, Customization
|
274
|
3035 @unnumberedsubsec Q3.2.3: How can I set the colors when highlighting a region?
|
82
|
3036
|
|
3037 How can I set the background/foreground colors when highlighting a
|
|
3038 region?
|
|
3039
|
|
3040 You can change the face @code{zmacs-region} either in your
|
|
3041 @file{.Xdefaults}:
|
|
3042
|
|
3043 @example
|
|
3044 Emacs.zmacs-region.attributeForeground: firebrick
|
|
3045 Emacs.zmacs-region.attributeBackground: lightseagreen
|
16
|
3046 @end example
|
|
3047
|
82
|
3048 or in your @file{.emacs}:
|
|
3049
|
|
3050 @lisp
|
282
|
3051 (set-face-background 'zmacs-region "red")
|
82
|
3052 (set-face-foreground 'zmacs-region "yellow")
|
|
3053 @end lisp
|
|
3054
|
|
3055 @node Q3.2.4, Q3.2.5, Q3.2.3, Customization
|
274
|
3056 @unnumberedsubsec Q3.2.4: How can I limit color map usage?
|
82
|
3057
|
|
3058 I'm using Netscape (or another color grabber like XEmacs);
|
|
3059 is there anyway to limit the number of available colors in the color map?
|
|
3060
|
126
|
3061 XEmacs 19.13 didn't have such a mechanism (unlike netscape, or other
|
82
|
3062 color-hogs). One solution is to start XEmacs prior to netscape, since
|
|
3063 this will prevent Netscape from grabbing all colors (but Netscape will
|
|
3064 complain). You can use the flags for Netscape, like -mono, -ncols <#>
|
|
3065 or -install (for mono, limiting to <#> colors, or for using a private
|
|
3066 color map). Since Netscape will take the entire colormap and never
|
|
3067 release it, the only reasonable way to run it is with @samp{-install}.
|
|
3068
|
|
3069 If you have the money, another solution would be to use a truecolor or
|
|
3070 direct color video.
|
|
3071
|
|
3072 Starting with XEmacs 19.14, XEmacs uses the closest available color if
|
|
3073 the colormap is full, so it's O.K. now to start Netscape first.
|
|
3074
|
282
|
3075 @node Q3.2.5, Q3.2.6, Q3.2.4, Customization
|
274
|
3076 @unnumberedsubsec Q3.2.5: My tty supports color, but XEmacs doesn't use them.
|
82
|
3077
|
|
3078 XEmacs tries to automatically determine whether your tty supports color,
|
|
3079 but sometimes guesses wrong. In that case, you can make XEmacs Do The
|
|
3080 Right Thing using this Lisp code:
|
|
3081
|
|
3082 @lisp
|
|
3083 (if (eq 'tty (device-type))
|
|
3084 (set-device-class nil 'color))
|
|
3085 @end lisp
|
|
3086
|
282
|
3087 @node Q3.2.6, Q3.3.1, Q3.2.5, Customization
|
|
3088 @unnumberedsubsec Q3.2.6: Can I have pixmap backgrounds in XEmacs?
|
|
3089 @c New
|
|
3090 @email{jvillaci@@wahnsinnig.extreme.indiana.edu, Juan Villacis} writes:
|
|
3091
|
|
3092 @quotation
|
|
3093 There are several ways to do it. For example, you could specify a
|
|
3094 default pixmap image to use in your @file{~/.Xresources}, e.g.,
|
|
3095
|
|
3096
|
|
3097 @example
|
|
3098 Emacs*EmacsFrame.default.attributeBackgroundPixmap: /path/to/image.xpm
|
|
3099 @end example
|
|
3100
|
|
3101
|
|
3102 and then reload ~/.Xresources and restart XEmacs. Alternatively,
|
|
3103 since each face can have its own pixmap background, a better way
|
|
3104 would be to set a face's pixmap within your XEmacs init file, e.g.,
|
|
3105
|
|
3106 @lisp
|
|
3107 (set-face-background-pixmap 'default "/path/to/image.xpm")
|
|
3108 (set-face-background-pixmap 'bold "/path/to/another_image.xpm")
|
|
3109 @end lisp
|
|
3110
|
|
3111 and so on. You can also do this interactively via @kbd{M-x edit-faces}.
|
|
3112
|
|
3113 @end quotation
|
|
3114
|
|
3115 @unnumberedsec 3.3: The Modeline
|
|
3116 @node Q3.3.1, Q3.3.2, Q3.2.6, Customization
|
274
|
3117 @unnumberedsubsec Q3.3.1: How can I make the modeline go away?
|
82
|
3118
|
|
3119 @lisp
|
|
3120 (set-specifier has-modeline-p nil)
|
|
3121 @end lisp
|
|
3122
|
|
3123 Starting with XEmacs 19.14 the modeline responds to mouse clicks, so if
|
|
3124 you haven't liked or used the modeline in the past, you might want to
|
|
3125 try the new version out.
|
|
3126
|
|
3127 @node Q3.3.2, Q3.3.3, Q3.3.1, Customization
|
274
|
3128 @unnumberedsubsec Q3.3.2: How do you have XEmacs display the line number in the modeline?
|
82
|
3129
|
|
3130 Add the following line to your @file{.emacs} file to display the
|
|
3131 line number:
|
|
3132
|
|
3133 @lisp
|
215
|
3134 (line-number-mode 1)
|
82
|
3135 @end lisp
|
|
3136
|
|
3137 Use the following to display the column number:
|
|
3138
|
|
3139 @lisp
|
215
|
3140 (column-number-mode 1)
|
82
|
3141 @end lisp
|
|
3142
|
215
|
3143 Or select from the @code{Options} menu
|
274
|
3144 @iftex
|
|
3145 @*
|
282
|
3146 @end iftex
|
274
|
3147 @code{Customize->Emacs->Editing->Basics->Line Number Mode}
|
215
|
3148 and/or
|
274
|
3149 @iftex
|
|
3150 @*
|
282
|
3151 @end iftex
|
274
|
3152 @code{Customize->Emacs->Editing->Basics->Column Number Mode}
|
215
|
3153
|
282
|
3154 Or type @kbd{M-x customize @key{RET} editing-basics @key{RET}}.
|
215
|
3155
|
82
|
3156 @node Q3.3.3, Q3.3.4, Q3.3.2, Customization
|
274
|
3157 @unnumberedsubsec Q3.3.3: How do I get XEmacs to put the time of day on the modeline?
|
82
|
3158
|
215
|
3159 Add the following line to your @file{.emacs} file to display the
|
|
3160 time:
|
|
3161
|
82
|
3162 @lisp
|
|
3163 (display-time)
|
|
3164 @end lisp
|
|
3165
|
215
|
3166 See @code{Customize} from the @code{Options} menu for customization.
|
|
3167
|
82
|
3168 @node Q3.3.4, Q3.3.5, Q3.3.3, Customization
|
274
|
3169 @unnumberedsubsec Q3.3.4: How do I turn off current chapter from AUC TeX modeline?
|
163
|
3170
|
|
3171 With AUC TeX, fast typing is hard because the current chapter, section
|
82
|
3172 etc. are given in the modeline. How can I turn this off?
|
|
3173
|
163
|
3174 It's not AUC TeX, it comes from @code{func-menu} in @file{func-menu.el}.
|
82
|
3175 Add this code to your @file{.emacs} to turn it off:
|
|
3176
|
|
3177 @lisp
|
|
3178 (setq fume-display-in-modeline-p nil)
|
|
3179 @end lisp
|
|
3180
|
|
3181 Or just add a hook to @code{TeX-mode-hook} to turn it off only for TeX
|
|
3182 mode:
|
|
3183
|
|
3184 @lisp
|
282
|
3185 (add-hook 'TeX-mode-hook
|
274
|
3186 '(lambda () (setq fume-display-in-modeline-p nil)))
|
82
|
3187 @end lisp
|
|
3188
|
274
|
3189 @email{dhughes@@origin-at.co.uk, David Hughes} writes:
|
82
|
3190
|
|
3191 @quotation
|
|
3192 If you have 19.14 or later, try this instead; you'll still get the
|
|
3193 function name displayed in the modeline, but it won't attempt to keep
|
|
3194 track when you modify the file. To refresh when it gets out of synch,
|
|
3195 you simply need click on the @samp{Rescan Buffer} option in the
|
|
3196 function-menu.
|
|
3197
|
|
3198 @lisp
|
|
3199 (setq-default fume-auto-rescan-buffer-p nil)
|
|
3200 @end lisp
|
|
3201 @end quotation
|
|
3202
|
|
3203 @node Q3.3.5, Q3.4.1, Q3.3.4, Customization
|
274
|
3204 @unnumberedsubsec Q3.3.5: How can one change the modeline color based on the mode used?
|
82
|
3205
|
|
3206 You can use something like the following:
|
|
3207
|
|
3208 @lisp
|
282
|
3209 (add-hook 'lisp-mode-hook
|
163
|
3210 (lambda ()
|
|
3211 (set-face-background 'modeline "red" (current-buffer))))
|
82
|
3212 @end lisp
|
|
3213
|
|
3214 Then, when editing a Lisp file (i.e. when in Lisp mode), the modeline
|
|
3215 colors change from the default set in your @file{.emacs}. The change
|
|
3216 will only be made in the buffer you just entered (which contains the
|
|
3217 Lisp file you are editing) and will not affect the modeline colors
|
|
3218 anywhere else.
|
|
3219
|
|
3220 Notes:
|
|
3221
|
|
3222 @itemize @bullet
|
|
3223
|
|
3224 @item
|
|
3225 The hook is the mode name plus @code{-hook}. eg. c-mode-hook,
|
|
3226 c++-mode-hook, emacs-lisp-mode-hook (used for your @file{.emacs} or a
|
|
3227 @file{xx.el} file), lisp-interaction-mode-hook (the @samp{*scratch*}
|
|
3228 buffer), text-mode-hook, etc.
|
|
3229
|
|
3230 @item
|
|
3231 Be sure to use @code{add-hook}, not @code{(setq c-mode-hook xxxx)},
|
|
3232 otherwise you will erase anything that anybody has already put on the
|
|
3233 hook.
|
|
3234
|
|
3235 @item
|
|
3236 You can also do @code{(set-face-font 'modeline @var{font})},
|
|
3237 eg. @code{(set-face-font 'modeline "*bold-r-normal*140-100-100*"
|
|
3238 (current-buffer))} if you wish the modeline font to vary based on the
|
|
3239 current mode.
|
|
3240 @end itemize
|
|
3241
|
126
|
3242 This works in 19.15 as well, but there are additional modeline faces,
|
82
|
3243 @code{modeline-buffer-id}, @code{modeline-mousable}, and
|
|
3244 @code{modeline-mousable-minor-mode}, which you may want to customize.
|
|
3245
|
|
3246 @node Q3.4.1, Q3.4.2, Q3.3.5, Customization
|
274
|
3247 @unnumberedsec 3.4: Multiple Device Support
|
|
3248 @unnumberedsubsec Q3.4.1: How do I open a frame on another screen of my multi-headed display?
|
82
|
3249
|
163
|
3250 The support for this was revamped for 19.14. Use the command
|
82
|
3251 @kbd{M-x make-frame-on-display}. This command is also on the File menu
|
|
3252 in the menubar.
|
|
3253
|
163
|
3254 XEmacs 19.14 and later also have the command @code{make-frame-on-tty}
|
|
3255 which will establish a connection to any tty-like device. Opening the
|
|
3256 TTY devices should be left to @code{gnuclient}, though.
|
82
|
3257
|
|
3258 @node Q3.4.2, Q3.5.1, Q3.4.1, Customization
|
274
|
3259 @unnumberedsubsec Q3.4.2: Can I really connect to a running XEmacs after calling up over a modem? How?
|
82
|
3260
|
|
3261 If you're not running at least XEmacs 19.14, you can't. Otherwise check
|
163
|
3262 out the @code{gnuattach} program supplied with XEmacs. Starting with
|
227
|
3263 XEmacs 20.3, @code{gnuattach} and @code{gnudoit} functionality is
|
163
|
3264 provided by @code{gnuclient}.
|
82
|
3265
|
227
|
3266 Also @xref{Q5.0.12}.
|
|
3267
|
82
|
3268 @node Q3.5.1, Q3.5.2, Q3.4.2, Customization
|
274
|
3269 @unnumberedsec 3.5: The Keyboard
|
|
3270 @unnumberedsubsec Q3.5.1: How can I bind complex functions (or macros) to keys?
|
82
|
3271
|
|
3272 As an example, say you want the @kbd{paste} key on a Sun keyboard to
|
|
3273 insert the current Primary X selection at point. You can accomplish this
|
|
3274 with:
|
|
3275
|
|
3276 @lisp
|
|
3277 (define-key global-map [f18] 'x-insert-selection)
|
|
3278 @end lisp
|
|
3279
|
|
3280 However, this only works if there is a current X selection (the
|
|
3281 selection will be highlighted). The functionality I like is for the
|
|
3282 @kbd{paste} key to insert the current X selection if there is one,
|
|
3283 otherwise insert the contents of the clipboard. To do this you need to
|
|
3284 pass arguments to @code{x-insert-selection}. This is done by wrapping
|
|
3285 the call in a 'lambda form:
|
|
3286
|
|
3287 @lisp
|
163
|
3288 (global-set-key [f18]
|
274
|
3289 (lambda () (interactive) (x-insert-selection t nil)))
|
82
|
3290 @end lisp
|
|
3291
|
|
3292 This binds the f18 key to a @dfn{generic} functional object. The
|
|
3293 interactive spec is required because only interactive functions can be
|
163
|
3294 bound to keys.
|
82
|
3295
|
|
3296 For the FAQ example you could use:
|
|
3297
|
|
3298 @lisp
|
|
3299 (global-set-key [(control ?.)]
|
274
|
3300 (lambda () (interactive) (scroll-up 1)))
|
|
3301 (global-set-key [(control ? ;)]
|
|
3302 (lambda () (interactive) (scroll-up -1)))
|
82
|
3303 @end lisp
|
|
3304
|
|
3305 This is fine if you only need a few functions within the lambda body.
|
|
3306 If you're doing more it's cleaner to define a separate function as in
|
|
3307 question 3.5.3 (@xref{Q3.5.3}).
|
|
3308
|
|
3309 @node Q3.5.2, Q3.5.3, Q3.5.1, Customization
|
274
|
3310 @unnumberedsubsec Q3.5.2: How can I stop down-arrow from adding empty lines to the bottom of my buffers?
|
82
|
3311
|
|
3312 Add the following line to your @file{.emacs} file:
|
|
3313
|
|
3314 @lisp
|
|
3315 (setq next-line-add-newlines nil)
|
|
3316 @end lisp
|
|
3317
|
163
|
3318 This has been the default setting in XEmacs for some time.
|
|
3319
|
82
|
3320 @node Q3.5.3, Q3.5.4, Q3.5.2, Customization
|
274
|
3321 @unnumberedsubsec Q3.5.3: How do I bind C-. and C-; to scroll one line up and down?
|
|
3322
|
|
3323 Add the following (Thanks to @email{mly@@adoc.xerox.com, Richard Mlynarik} and
|
|
3324 @email{wayne@@zen.cac.stratus.com, Wayne Newberry}) to @file{.emacs}:
|
82
|
3325
|
|
3326 @lisp
|
|
3327 (defun scroll-up-one-line ()
|
|
3328 (interactive)
|
|
3329 (scroll-up 1))
|
|
3330
|
|
3331 (defun scroll-down-one-line ()
|
|
3332 (interactive)
|
|
3333 (scroll-down 1))
|
|
3334
|
274
|
3335 (global-set-key [(control ?.)] 'scroll-up-one-line) ; C-.
|
|
3336 (global-set-key [(control ? ;)] 'scroll-down-one-line) ; C-;
|
82
|
3337 @end lisp
|
|
3338
|
|
3339 The key point is that you can only bind simple functions to keys; you
|
|
3340 can not bind a key to a function that you're also passing arguments to.
|
|
3341 (@xref{Q3.5.1} for a better answer).
|
|
3342
|
|
3343 @node Q3.5.4, Q3.5.5, Q3.5.3, Customization
|
274
|
3344 @unnumberedsubsec Q3.5.4: Globally binding @kbd{Delete}?
|
82
|
3345
|
|
3346 I cannot manage to globally bind my @kbd{Delete} key to something other
|
|
3347 than the default. How does one do this?
|
|
3348
|
|
3349 @lisp
|
163
|
3350 (defun foo ()
|
82
|
3351 (interactive)
|
163
|
3352 (message "You hit DELETE"))
|
|
3353
|
|
3354 (global-set-key 'delete 'foo)
|
82
|
3355 @end lisp
|
|
3356
|
|
3357 However, some modes explicitly bind @kbd{Delete}, so you would need to
|
227
|
3358 add a hook that does @code{local-set-key} for them. If what you want to
|
82
|
3359 do is make the Backspace and Delete keys work more PC/Motif-like, then
|
215
|
3360 take a look at the @file{delbs.el} package.
|
82
|
3361
|
|
3362 New in XEmacs 19.14 is a variable called @code{key-translation-map}
|
227
|
3363 which makes it easier to bind @kbd{Delete}. @file{delbs.el} is a
|
82
|
3364 good example of how to do this correctly.
|
|
3365
|
215
|
3366 Also @xref{Q3.5.10}.
|
|
3367
|
82
|
3368 @node Q3.5.5, Q3.5.6, Q3.5.4, Customization
|
274
|
3369 @unnumberedsubsec Q3.5.5: Scrolling one line at a time.
|
82
|
3370
|
|
3371 Can the cursor keys scroll the screen a line at a time, rather than the
|
|
3372 default half page jump? I tend it to find it disorienting.
|
|
3373
|
|
3374 Try this:
|
|
3375
|
|
3376 @lisp
|
|
3377 (defun scroll-one-line-up (&optional arg)
|
|
3378 "Scroll the selected window up (forward in the text) one line (or N lines)."
|
|
3379 (interactive "p")
|
|
3380 (scroll-up (or arg 1)))
|
|
3381
|
|
3382 (defun scroll-one-line-down (&optional arg)
|
|
3383 "Scroll the selected window down (backward in the text) one line (or N)."
|
|
3384 (interactive "p")
|
|
3385 (scroll-down (or arg 1)))
|
|
3386
|
163
|
3387 (global-set-key [up] 'scroll-one-line-up)
|
|
3388 (global-set-key [down] 'scroll-one-line-down)
|
82
|
3389 @end lisp
|
|
3390
|
|
3391 The following will also work but will affect more than just the cursor
|
|
3392 keys (i.e. @kbd{C-n} and @kbd{C-p}):
|
|
3393
|
|
3394 @lisp
|
|
3395 (setq scroll-step 1)
|
|
3396 @end lisp
|
|
3397
|
227
|
3398 Starting with XEmacs-20.3 you can also change this with Customize.
|
215
|
3399 Select from the @code{Options} menu
|
227
|
3400 @code{Customize->Emacs->Environment->Windows->Scroll Step...} or type
|
282
|
3401 @kbd{M-x customize @key{RET} windows @key{RET}}.
|
215
|
3402
|
82
|
3403 @node Q3.5.6, Q3.5.7, Q3.5.5, Customization
|
274
|
3404 @unnumberedsubsec Q3.5.6: How to map @kbd{Help} key alone on Sun type4 keyboard?
|
82
|
3405
|
|
3406 The following works in GNU Emacs 19:
|
|
3407
|
|
3408 @lisp
|
274
|
3409 (global-set-key [help] 'help-command);; Help
|
82
|
3410 @end lisp
|
|
3411
|
126
|
3412 The following works in XEmacs 19.15 with the addition of shift:
|
82
|
3413
|
|
3414 @lisp
|
274
|
3415 (global-set-key [(shift help)] 'help-command);; Help
|
82
|
3416 @end lisp
|
|
3417
|
|
3418 But it doesn't work alone. This is in the file @file{PROBLEMS} which
|
|
3419 should have come with your XEmacs installation: @emph{Emacs ignores the
|
|
3420 @kbd{help} key when running OLWM}.
|
|
3421
|
|
3422 OLWM grabs the @kbd{help} key, and retransmits it to the appropriate
|
282
|
3423 client using
|
274
|
3424 @iftex
|
|
3425 @*
|
282
|
3426 @end iftex
|
274
|
3427 @code{XSendEvent}. Allowing Emacs to react to synthetic
|
82
|
3428 events is a security hole, so this is turned off by default. You can
|
|
3429 enable it by setting the variable @code{x-allow-sendevents} to t. You
|
|
3430 can also cause fix this by telling OLWM to not grab the help key, with
|
|
3431 the null binding @code{OpenWindows.KeyboardCommand.Help:}.
|
|
3432
|
|
3433 @node Q3.5.7, Q3.5.8, Q3.5.6, Customization
|
274
|
3434 @unnumberedsubsec Q3.5.7: How can you type in special characters in XEmacs?
|
282
|
3435 @c Changed
|
227
|
3436 One way is to use the package @code{x-compose}. Then you can use
|
82
|
3437 sequences like @kbd{Compose " a} to get ä, etc.
|
|
3438
|
227
|
3439 Another way is to use the @code{iso-insert} package, provided in XEmacs
|
|
3440 19.15 and later. Then you can use sequences like @kbd{C-x 8 " a} to get
|
|
3441 ä, etc.
|
82
|
3442
|
282
|
3443 @email{glynn@@sensei.co.uk, Glynn Clements} writes:
|
|
3444
|
|
3445 @quotation
|
|
3446 It depends upon your X server.
|
|
3447
|
|
3448 Generally, the simplest way is to define a key as Multi_key with
|
|
3449 xmodmap, e.g.
|
|
3450 @c hey, show some respect, willya -- there's xkeycaps, isn't there? --
|
|
3451 @c chr ;)
|
|
3452 @example
|
|
3453 xmodmap -e 'keycode 0xff20 = Multi_key'
|
|
3454 @end example
|
|
3455
|
|
3456 You will need to pick an appropriate keycode. Use xev to find out the
|
|
3457 keycodes for each key.
|
|
3458
|
|
3459 [NB: On a `Windows' keyboard, recent versions of XFree86 automatically
|
|
3460 define the right `Windows' key as Multi_key'.]
|
|
3461
|
|
3462 Once you have Multi_key defined, you can use e.g.
|
|
3463 @example
|
|
3464 Multi a ' => á
|
|
3465 Multi e " => ë
|
|
3466 Multi c , => ç
|
|
3467 @end example
|
|
3468
|
|
3469 etc.
|
|
3470
|
|
3471 Also, recent versions of XFree86 define various AltGr-<key>
|
|
3472 combinations as dead keys, i.e.
|
|
3473 @example
|
|
3474 AltGr [ => dead_diaeresis
|
|
3475 AltGr ] => dead_tilde
|
|
3476 AltGr ; => dead_acute
|
|
3477 @end example
|
|
3478 etc.
|
|
3479
|
|
3480 Running @samp{xmodmap -pk} will list all of the defined keysyms.
|
|
3481 @end quotation
|
|
3482
|
82
|
3483 @node Q3.5.8, Q3.5.9, Q3.5.7, Customization
|
274
|
3484 @unnumberedsubsec Q3.5.8: Why does @code{(global-set-key [delete-forward] 'delete-char)} complain?
|
82
|
3485
|
|
3486 Why does @code{(define-key global-map [ delete-forward ] 'delete-char)}
|
|
3487 complain of not being able to bind an unknown key?
|
|
3488
|
|
3489 Try this instead:
|
|
3490
|
|
3491 @lisp
|
|
3492 (define-key global-map [delete_forward] 'delete-char)
|
|
3493 @end lisp
|
|
3494
|
|
3495 and it will work.
|
|
3496
|
|
3497 What you are seeing above is a bug due to code that is trying to check
|
|
3498 for GNU Emacs syntax like:
|
|
3499
|
|
3500 (define-key global-map [C-M-a] 'delete-char)
|
|
3501
|
|
3502 which otherwise would cause no errors but would not result in the
|
|
3503 expected behavior.
|
|
3504
|
|
3505 This bug has been fixed in 19.14.
|
|
3506
|
|
3507 @node Q3.5.9, Q3.5.10, Q3.5.8, Customization
|
274
|
3508 @unnumberedsubsec Q3.5.9: How do I make the Delete key delete forward?
|
82
|
3509
|
227
|
3510 With XEmacs-20.2 use the @code{delbs} package:
|
82
|
3511
|
|
3512 @lisp
|
163
|
3513 (require 'delbs)
|
82
|
3514 @end lisp
|
|
3515
|
163
|
3516 This will give you the functions @code{delbs-enable-delete-forward} to
|
|
3517 set things up, and @code{delbs-disable-delete-forward} to revert to
|
227
|
3518 ``normal'' behavior. Note that @code{delbackspace} package is obsolete.
|
|
3519
|
|
3520 Starting with XEmacs-20.3 better solution is to set variable
|
|
3521 @code{delete-key-deletes-forward} to t. You can also change this with
|
|
3522 Customize. Select from the @code{Options} menu
|
|
3523 @code{Customize->Emacs->Editing->Basics->Delete Key Deletes Forward} or
|
282
|
3524 type @kbd{M-x customize @key{RET} editing-basics @key{RET}}.
|
215
|
3525
|
82
|
3526 Also @xref{Q3.5.4}.
|
|
3527
|
282
|
3528 @node Q3.5.10, Q3.5.11, Q3.5.9, Customization
|
274
|
3529 @unnumberedsubsec Q3.5.10: Can I turn on @dfn{sticky} modifier keys?
|
82
|
3530
|
|
3531 Yes, with @code{(setq modifier-keys-are-sticky t)}. This will give the
|
|
3532 effect of being able to press and release Shift and have the next
|
|
3533 character typed come out in upper case. This will affect all the other
|
|
3534 modifier keys like Control and Meta as well.
|
|
3535
|
274
|
3536 @email{ben@@666.com, Ben Wing} writes:
|
82
|
3537
|
|
3538 @quotation
|
|
3539 One thing about the sticky modifiers is that if you move the mouse out
|
163
|
3540 of the frame and back in, it cancels all currently ``stuck'' modifiers.
|
82
|
3541 @end quotation
|
|
3542
|
282
|
3543 @node Q3.5.11, Q3.6.1, Q3.5.10, Customization
|
|
3544 @unnumberedsubsec Q3.5.11: How do I map the arrow keys?
|
|
3545 @c New
|
|
3546 Say you want to map @kbd{C-@key{right}} to forward-word:
|
|
3547
|
|
3548 @email{sds@@usa.net, Sam Steingold} writes:
|
|
3549
|
|
3550 @quotation
|
|
3551 @lisp
|
|
3552 ; both XEmacs and Emacs
|
|
3553 (define-key global-map [(control right)] 'forward-word)
|
|
3554 @end lisp
|
|
3555 or
|
|
3556 @lisp
|
|
3557 ; Emacs only
|
|
3558 (define-key global-map [C-right] 'forward-word)
|
|
3559 @end lisp
|
|
3560 or
|
|
3561 @lisp
|
|
3562 ; ver > 20, both
|
|
3563 (define-key global-map (kbd "C-<right>") 'forward-word)
|
|
3564 @end lisp
|
|
3565 @end quotation
|
|
3566
|
|
3567
|
|
3568
|
|
3569 @node Q3.6.1, Q3.6.2, Q3.5.11, Customization
|
274
|
3570 @unnumberedsec 3.6: The Cursor
|
|
3571 @unnumberedsubsec Q3.6.1: Is there a way to make the bar cursor thicker?
|
82
|
3572
|
|
3573 I'd like to have the bar cursor a little thicker, as I tend to "lose" it
|
|
3574 often.
|
|
3575
|
|
3576 For a 1 pixel bar cursor, use:
|
|
3577
|
|
3578 @lisp
|
|
3579 (setq bar-cursor t)
|
|
3580 @end lisp
|
|
3581
|
|
3582 For a 2 pixel bar cursor, use:
|
|
3583
|
|
3584 @lisp
|
|
3585 (setq bar-cursor 'anything-else)
|
|
3586 @end lisp
|
|
3587
|
227
|
3588 Starting with XEmacs-20.3 you can also change these with Customize.
|
215
|
3589 Select from the @code{Options} menu
|
227
|
3590 @code{Customize->Emacs->Environment->Display->Bar Cursor...} or type
|
282
|
3591 @kbd{M-x customize @key{RET} display @key{RET}}.
|
215
|
3592
|
82
|
3593 You can use a color to make it stand out better:
|
|
3594
|
|
3595 @example
|
|
3596 Emacs*cursorColor: Red
|
|
3597 @end example
|
|
3598
|
|
3599 @node Q3.6.2, Q3.6.3, Q3.6.1, Customization
|
274
|
3600 @unnumberedsubsec Q3.6.2: Is there a way to get back the block cursor?
|
82
|
3601
|
|
3602 @lisp
|
|
3603 (setq bar-cursor nil)
|
|
3604 @end lisp
|
|
3605
|
227
|
3606 Starting with XEmacs-20.3 you can also change this with Customize.
|
215
|
3607 Select from the @code{Options} menu
|
227
|
3608 @code{Customize->Emacs->Environment->Display->Bar Cursor...} or type
|
282
|
3609 @kbd{M-x customize @key{RET} display @key{RET}}.
|
215
|
3610
|
82
|
3611 @node Q3.6.3, Q3.7.1, Q3.6.2, Customization
|
274
|
3612 @unnumberedsubsec Q3.6.3: Can I make the cursor blink?
|
82
|
3613
|
|
3614 If you are running a version of XEmacs older than 19.14, no. Otherwise
|
|
3615 you can do the following:
|
|
3616
|
|
3617 @lisp
|
|
3618 (blink-cursor-mode)
|
|
3619 @end lisp
|
|
3620
|
|
3621 This function toggles between a steady cursor and a blinking cursor.
|
|
3622 You may also set this mode from the menu bar by selecting @samp{Options
|
227
|
3623 => Frame Appearance => Blinking Cursor}. Remember to save options.
|
82
|
3624
|
|
3625 @node Q3.7.1, Q3.7.2, Q3.6.3, Customization
|
274
|
3626 @unnumberedsec 3.7: The Mouse and Highlighting
|
|
3627 @unnumberedsubsec Q3.7.1: How can I turn off Mouse pasting?
|
82
|
3628
|
|
3629 I keep hitting the middle mouse button by accident and getting stuff
|
|
3630 pasted into my buffer so how can I turn this off?
|
|
3631
|
|
3632 Here is an alternative binding, whereby the middle mouse button selects
|
|
3633 (but does not cut) the expression under the mouse. Clicking middle on a
|
|
3634 left or right paren will select to the matching one. Note that you can
|
|
3635 use @code{define-key} or @code{global-set-key}.
|
|
3636
|
|
3637 @lisp
|
163
|
3638 (defun mouse-set-point-and-select (event)
|
82
|
3639 "Sets the point at the mouse location, then marks following form"
|
|
3640 (interactive "@@e")
|
|
3641 (mouse-set-point event)
|
163
|
3642 (mark-sexp 1))
|
|
3643 (define-key global-map [button2] 'mouse-set-point-and-select)
|
82
|
3644 @end lisp
|
|
3645
|
|
3646 @node Q3.7.2, Q3.7.3, Q3.7.1, Customization
|
274
|
3647 @unnumberedsubsec Q3.7.2: How do I set control/meta/etc modifiers on mouse buttons?
|
82
|
3648
|
227
|
3649 Use, for instance, @code{[(meta button1)]}. For example, here is a common
|
|
3650 setting for Common Lisp programmers who use the bundled @code{ilisp}
|
|
3651 package, whereby meta-button1 on a function name will find the file where
|
|
3652 the function name was defined, and put you at that location in the source
|
|
3653 file.
|
82
|
3654
|
|
3655 [Inside a function that gets called by the lisp-mode-hook and
|
|
3656 ilisp-mode-hook]
|
|
3657
|
|
3658 @lisp
|
|
3659 (local-set-key [(meta button1)] 'edit-definitions-lisp)
|
|
3660 @end lisp
|
|
3661
|
|
3662 @node Q3.7.3, Q3.7.4, Q3.7.2, Customization
|
274
|
3663 @unnumberedsubsec Q3.7.3: Clicking the left button does not do anything in buffer list.
|
82
|
3664
|
|
3665 I do @kbd{C-x C-b} to get a list of buffers and the entries get
|
|
3666 highlighted when I move the mouse over them but clicking the left mouse
|
|
3667 does not do anything.
|
|
3668
|
|
3669 Use the middle mouse button.
|
|
3670
|
|
3671 @node Q3.7.4, Q3.7.5, Q3.7.3, Customization
|
274
|
3672 @unnumberedsubsec Q3.7.4: How can I get a list of buffers when I hit mouse button 3?
|
82
|
3673
|
163
|
3674 The following code will replace the default popup on button3:
|
82
|
3675
|
|
3676 @lisp
|
163
|
3677 (global-set-key [button3] 'popup-buffer-menu)
|
82
|
3678 @end lisp
|
|
3679
|
|
3680 @node Q3.7.5, Q3.7.6, Q3.7.4, Customization
|
274
|
3681 @unnumberedsubsec Q3.7.5: Why does cut-and-paste not work between XEmacs and a cmdtool?
|
82
|
3682
|
|
3683 We don't know. It's a bug. There does seem to be a work-around,
|
|
3684 however. Try running xclipboard first. It appears to fix the problem
|
|
3685 even if you exit it. (This should be mostly fixed in 19.13, but we
|
|
3686 haven't yet verified that).
|
|
3687
|
|
3688 @node Q3.7.6, Q3.7.7, Q3.7.5, Customization
|
274
|
3689 @unnumberedsubsec Q3.7.6: How I can set XEmacs up so that it pastes where the text cursor is?
|
82
|
3690
|
|
3691 By default XEmacs pastes X selections where the mouse pointer is. How
|
|
3692 do I disable this?
|
|
3693
|
|
3694 Examine the function @code{mouse-yank}, by typing @kbd{C-h f mouse-yank
|
282
|
3695 @key{RET}}.
|
82
|
3696
|
|
3697 To get XEmacs to paste at the text cursor, add this your @file{.emacs}:
|
|
3698
|
|
3699 @lisp
|
|
3700 (setq mouse-yank-at-point t)
|
|
3701 @end lisp
|
|
3702
|
227
|
3703 Starting with XEmacs-20.2 you can also change this with Customize.
|
|
3704 Select from the @code{Options} menu
|
|
3705 @code{Customize->Emacs->Editing->Mouse->Yank At Point...} or type
|
282
|
3706 @kbd{M-x customize @key{RET} mouse @key{RET}}.
|
227
|
3707
|
82
|
3708 @node Q3.7.7, Q3.7.8, Q3.7.6, Customization
|
274
|
3709 @unnumberedsubsec Q3.7.7: How do I select a rectangular region?
|
82
|
3710
|
|
3711 Just select the region normally, then use the rectangle commands (e.g.
|
|
3712 @code{kill-rectangle} on it. The region does not highlight as a
|
|
3713 rectangle, but the commands work just fine.
|
|
3714
|
227
|
3715 To actually sweep out rectangular regions with the mouse you can use
|
|
3716 @code{mouse-track-do-rectangle} which is assigned to @kbd{M-button1}.
|
|
3717 Then use rectangle commands.
|
|
3718
|
|
3719 You can also do the following to change default behavior to sweep out
|
|
3720 rectangular regions:
|
82
|
3721
|
|
3722 @lisp
|
|
3723 (setq mouse-track-rectangle-p t)
|
|
3724 @end lisp
|
|
3725
|
227
|
3726 Starting with XEmacs-20.2 you can also change this with Customize.
|
|
3727 Select from the @code{Options} menu
|
|
3728 @code{Customize->Emacs->Editing->Mouse->Track Rectangle...} or type
|
282
|
3729 @kbd{M-x customize @key{RET} mouse @key{RET}}.
|
227
|
3730
|
82
|
3731
|
|
3732 @example
|
|
3733 mouse-track-do-rectangle: (event)
|
|
3734 -- an interactive compiled Lisp function.
|
|
3735 Like `mouse-track' but selects rectangles instead of regions.
|
|
3736 @end example
|
|
3737
|
|
3738 @node Q3.7.8, Q3.8.1, Q3.7.7, Customization
|
274
|
3739 @unnumberedsubsec Q3.7.8: Why does @kbd{M-w} take so long?
|
82
|
3740
|
|
3741 It actually doesn't. It leaves the region visible for a second so that
|
|
3742 you can see what area is being yanked. If you start working, though, it
|
|
3743 will immediately complete its operation. In other words, it will only
|
|
3744 delay for a second if you let it.
|
|
3745
|
|
3746 @node Q3.8.1, Q3.8.2, Q3.7.8, Customization
|
274
|
3747 @unnumberedsec 3.8: The Menubar and Toolbar
|
|
3748 @unnumberedsubsec Q3.8.1: How do I get rid of the menu (or menubar)?
|
82
|
3749
|
|
3750 If you are running XEmacs 19.13 and earlier, add this command to your
|
|
3751 @file{.emacs}.
|
|
3752
|
|
3753 @lisp
|
|
3754 (set-menubar nil)
|
|
3755 @end lisp
|
|
3756
|
|
3757 Starting with XEmacs 19.14 the preferred method is:
|
|
3758
|
|
3759 @lisp
|
|
3760 (set-specifier menubar-visible-p nil)
|
|
3761 @end lisp
|
|
3762
|
|
3763 @node Q3.8.2, Q3.8.3, Q3.8.1, Customization
|
274
|
3764 @unnumberedsubsec Q3.8.2: Can I customize the basic menubar?
|
82
|
3765
|
|
3766 For an extensive menubar, add this line to your @file{.emacs}:
|
|
3767
|
|
3768 @lisp
|
|
3769 (load "big-menubar")
|
|
3770 @end lisp
|
|
3771
|
|
3772 If you'd like to write your own, this file provides as good a set of
|
|
3773 examples as any to start from. The file is located in
|
|
3774 @file{lisp/packages/big-menubar.el} in the XEmacs installation
|
|
3775 directory.
|
|
3776
|
|
3777 @node Q3.8.3, Q3.8.4, Q3.8.2, Customization
|
274
|
3778 @unnumberedsubsec Q3.8.3: How do I control how many buffers are listed in the menu @code{Buffers List}?
|
82
|
3779
|
|
3780 Add the following to your @file{.emacs} (suit to fit):
|
|
3781
|
|
3782 @lisp
|
|
3783 (setq buffers-menu-max-size 20)
|
|
3784 @end lisp
|
|
3785
|
|
3786 For no limit, use an argument of @samp{nil}.
|
|
3787
|
227
|
3788 Starting with XEmacs-20.3 you can also change this with Customize.
|
|
3789 Select from the @code{Options} menu
|
|
3790 @code{Customize->Emacs->Environment->Menu->Buffers Menu->Max Size...} or
|
282
|
3791 type @kbd{M-x customize @key{RET} buffers-menu @key{RET}}.
|
227
|
3792
|
82
|
3793 @node Q3.8.4, Q3.8.5, Q3.8.3, Customization
|
274
|
3794 @unnumberedsubsec Q3.8.4: Resources like @code{Emacs*menubar*font} are not working?
|
82
|
3795
|
|
3796 I am trying to use a resource like @code{Emacs*menubar*font} to set the
|
|
3797 font of the menubar but it's not working.
|
|
3798
|
|
3799 If you are using the real Motif menubar, this resource is not
|
|
3800 recognized; you have to say:
|
|
3801
|
|
3802 @example
|
|
3803 Emacs*menubar*fontList: FONT
|
|
3804 @end example
|
|
3805
|
|
3806 If you are using the Lucid menubar, the former resource will be
|
|
3807 recognized only if the latter resource is unset. This means that the
|
|
3808 resource
|
|
3809
|
|
3810 @example
|
|
3811 *fontList: FONT
|
|
3812 @end example
|
|
3813
|
|
3814 will override
|
|
3815
|
|
3816 @example
|
|
3817 Emacs*menubar*font: FONT
|
|
3818 @end example
|
|
3819
|
|
3820 even though the latter is more specific.
|
|
3821
|
|
3822 @node Q3.8.5, Q3.9.1, Q3.8.4, Customization
|
274
|
3823 @unnumberedsubsec Q3.8.5: How can I bind a key to a function to toggle the toolbar?
|
82
|
3824
|
|
3825 Try something like:
|
|
3826
|
|
3827 @lisp
|
163
|
3828 (defun my-toggle-toolbar ()
|
|
3829 (interactive)
|
|
3830 (set-specifier default-toolbar-visible-p
|
|
3831 (not (specifier-instance default-toolbar-visible-p))))
|
|
3832 (global-set-key "\C-xT" 'my-toggle-toolbar)
|
82
|
3833 @end lisp
|
|
3834
|
|
3835 There are redisplay bugs in 19.14 that may make the preceding result in
|
|
3836 a messed-up display, especially for frames with multiple windows. You
|
|
3837 may need to resize the frame before XEmacs completely realizes the
|
|
3838 toolbar is really gone.
|
|
3839
|
274
|
3840 Thanks to @email{martin@@xemacs.org, Martin Buchholz} for the correct
|
82
|
3841 code.
|
|
3842
|
|
3843 @node Q3.9.1, Q3.9.2, Q3.8.5, Customization
|
274
|
3844 @unnumberedsec 3.9: Scrollbars
|
|
3845 @unnumberedsubsec Q3.9.1: How can I disable the scrollbar?
|
82
|
3846
|
|
3847 To disable them for all frames, add the following line to
|
|
3848 your @file{.Xdefaults}:
|
|
3849
|
|
3850 @example
|
|
3851 Emacs.scrollBarWidth: 0
|
|
3852 @end example
|
|
3853
|
282
|
3854 Or select from the @code{Options} menu @code{Frame Appearance->Scrollbars}.
|
227
|
3855 Remember to save options.
|
|
3856
|
82
|
3857 To turn the scrollbar off on a per-frame basis, use the following
|
|
3858 function:
|
|
3859
|
|
3860 @lisp
|
163
|
3861 (set-specifier scrollbar-width 0 (selected-frame))
|
82
|
3862 @end lisp
|
|
3863
|
|
3864 You can actually turn the scrollbars on at any level you want by
|
|
3865 substituting for (selected-frame) in the above command. For example, to
|
|
3866 turn the scrollbars off only in a single buffer:
|
|
3867
|
|
3868 @lisp
|
163
|
3869 (set-specifier scrollbar-width 0 (current-buffer))
|
82
|
3870 @end lisp
|
|
3871
|
163
|
3872 In XEmacs versions prior to 19.14, you had to use the hairier construct:
|
82
|
3873
|
|
3874 @lisp
|
163
|
3875 (set-specifier scrollbar-width (cons (selected-frame) 0))
|
82
|
3876 @end lisp
|
|
3877
|
|
3878 @node Q3.9.2, Q3.9.3, Q3.9.1, Customization
|
274
|
3879 @unnumberedsubsec Q3.9.2: How can one use resources to change scrollbar colors?
|
82
|
3880
|
|
3881 Here's a recap of how to use resources to change your scrollbar colors:
|
|
3882
|
|
3883 @example
|
|
3884 ! Motif scrollbars
|
|
3885
|
|
3886 Emacs*XmScrollBar.Background: skyblue
|
|
3887 Emacs*XmScrollBar.troughColor: lightgray
|
|
3888
|
|
3889 ! Athena scrollbars
|
|
3890
|
|
3891 Emacs*Scrollbar.Foreground: skyblue
|
|
3892 Emacs*Scrollbar.Background: lightgray
|
|
3893 @end example
|
|
3894
|
|
3895 Note the capitalization of @code{Scrollbar} for the Athena widget.
|
|
3896
|
|
3897 @node Q3.9.3, Q3.9.4, Q3.9.2, Customization
|
274
|
3898 @unnumberedsubsec Q3.9.3: Moving the scrollbar can move the point; can I disable this?
|
82
|
3899
|
|
3900 When I move the scrollbar in an XEmacs window, it moves the point as
|
|
3901 well, which should not be the default behavior. Is this a bug or a
|
|
3902 feature? Can I disable it?
|
|
3903
|
|
3904 The current behavior is a feature, not a bug. Point remains at the same
|
|
3905 buffer position as long as that position does not scroll off the screen.
|
|
3906 In that event, point will end up in either the upper-left or lower-left
|
|
3907 hand corner.
|
|
3908
|
|
3909 This cannot be changed.
|
|
3910
|
|
3911 @node Q3.9.4, Q3.10.1, Q3.9.3, Customization
|
274
|
3912 @unnumberedsubsec Q3.9.4: How can I get automatic horizontal scrolling?
|
82
|
3913
|
|
3914 By the same token, how can I turn it off in specific modes?
|
|
3915
|
|
3916 To do this, add to your @file{.emacs} file:
|
|
3917
|
|
3918 @lisp
|
|
3919 (require 'auto-show)
|
|
3920 @end lisp
|
|
3921
|
|
3922 Then do @code{(setq truncate-lines t)} in the mode-hooks for any modes
|
|
3923 in which you want lines truncated.
|
|
3924
|
|
3925 More precisely: If @code{truncate-lines} is nil, horizontal scrollbars
|
|
3926 will never appear. Otherwise, they will appear only if the value of
|
|
3927 @code{scrollbar-height} for that buffer/window/etc. is non-zero. If you
|
|
3928 do
|
|
3929
|
|
3930 @lisp
|
|
3931 (set-specifier scrollbar-height 0)
|
|
3932 @end lisp
|
|
3933
|
|
3934 then horizontal scrollbars will not appear in truncated buffers unless
|
|
3935 the package specifically asked for them.
|
|
3936
|
|
3937 Automatic horizontal scrolling is now standard, starting with 19.14.
|
|
3938
|
|
3939 @node Q3.10.1, Q3.10.2, Q3.9.4, Customization
|
282
|
3940 @unnumberedsec 3.10: Text Selections
|
274
|
3941 @unnumberedsubsec Q3.10.1: How can I turn off or change highlighted selections?
|
82
|
3942
|
|
3943 The @code{zmacs} mode allows for what some might call gratuitous
|
|
3944 highlighting for selected regions (either by setting mark or by using
|
|
3945 the mouse). This is the default behavior. To turn off, add the
|
|
3946 following line to your @file{.emacs} file:
|
|
3947
|
|
3948 @lisp
|
|
3949 (setq zmacs-regions nil)
|
|
3950 @end lisp
|
|
3951
|
227
|
3952 Starting with XEmacs-20.2 you can also change this with Customize. Select
|
|
3953 from the @code{Options} menu @code{Customize->Emacs->Editing->Basics->Zmacs
|
282
|
3954 Regions} or type @kbd{M-x customize @key{RET} editing-basics @key{RET}}.
|
215
|
3955
|
126
|
3956 To change the face for selection, look at @code{Options->Customize} on
|
82
|
3957 the menubar.
|
|
3958
|
|
3959 @node Q3.10.2, Q3.10.3, Q3.10.1, Customization
|
274
|
3960 @unnumberedsubsec Q3.10.2: How do I get that typing on an active region removes it?
|
82
|
3961
|
|
3962 I want to change things so that if I select some text and start typing,
|
|
3963 the typed text replaces the selected text, similar to Motif.
|
|
3964
|
|
3965 You want to use something called @dfn{pending delete}. Pending delete
|
|
3966 is what happens when you select a region (with the mouse or keyboard)
|
|
3967 and you press a key to replace the selected region by the key you typed.
|
|
3968 Usually backspace kills the selected region.
|
|
3969
|
|
3970 To get this behavior, add the following line to your @file{.emacs}:
|
|
3971
|
|
3972 @lisp
|
215
|
3973 (turn-on-pending-delete)
|
82
|
3974 @end lisp
|
|
3975
|
|
3976 Note that this will work with both Backspace and Delete.
|
|
3977
|
|
3978 @node Q3.10.3, Q3.10.4, Q3.10.2, Customization
|
274
|
3979 @unnumberedsubsec Q3.10.3: Can I turn off the highlight during isearch?
|
82
|
3980
|
|
3981 I do not like my text highlighted while I am doing isearch as I am not
|
|
3982 able to see what's underneath. How do I turn it off?
|
|
3983
|
|
3984 Put the following in your @file{.emacs}:
|
|
3985
|
|
3986 @lisp
|
|
3987 (setq isearch-highlight nil)
|
|
3988 @end lisp
|
|
3989
|
227
|
3990 Starting with XEmacs-20.2 you can also change this with Customize. Type
|
282
|
3991 @kbd{M-x customize-variable @key{RET} isearch-highlight @key{RET}}.
|
215
|
3992
|
82
|
3993 Note also that isearch-highlight affects query-replace and ispell.
|
|
3994 Instead of disabling isearch-highlight you may find that a better
|
|
3995 solution consists of customizing the @code{isearch} face.
|
|
3996
|
|
3997 @node Q3.10.4, Q3.10.5, Q3.10.3, Customization
|
274
|
3998 @unnumberedsubsec Q3.10.4: How do I turn off highlighting after @kbd{C-x C-p} (mark-page)?
|
82
|
3999
|
|
4000 Put this in your @code{.emacs}:
|
|
4001
|
|
4002 @lisp
|
|
4003 (setq zmacs-regions nil)
|
|
4004 @end lisp
|
|
4005
|
|
4006 @strong{Warning: This command turns off all region highlighting.}
|
|
4007
|
215
|
4008 Also @xref{Q3.10.1}.
|
|
4009
|
82
|
4010 @node Q3.10.5, , Q3.10.4, Customization
|
274
|
4011 @unnumberedsubsec Q3.10.5: The region disappears when I hit the end of buffer while scrolling.
|
82
|
4012
|
227
|
4013 This has been fixed by default starting with XEmacs-20.3.
|
|
4014
|
|
4015 With older versions you can turn this feature (if it indeed is a feature)
|
|
4016 off like this:
|
82
|
4017
|
|
4018 @lisp
|
|
4019 (defadvice scroll-up (around scroll-up freeze)
|
|
4020 (interactive "_P")
|
|
4021 (let ((zmacs-region-stays t))
|
|
4022 (if (interactive-p)
|
|
4023 (condition-case nil
|
|
4024 ad-do-it
|
|
4025 (end-of-buffer (goto-char (point-max))))
|
|
4026 ad-do-it)))
|
|
4027
|
|
4028 (defadvice scroll-down (around scroll-down freeze)
|
|
4029 (interactive "_P")
|
|
4030 (let ((zmacs-region-stays t))
|
|
4031 (if (interactive-p)
|
|
4032 (condition-case nil
|
|
4033 ad-do-it
|
|
4034 (beginning-of-buffer (goto-char (point-min))))
|
|
4035 ad-do-it)))
|
|
4036 @end lisp
|
|
4037
|
274
|
4038 Thanks to @email{raman@@adobe.com, T. V. Raman} for assistance in deriving this
|
82
|
4039 answer.
|
|
4040
|
|
4041 @node Subsystems, Miscellaneous, Customization, Top
|
274
|
4042 @unnumbered 4 Major Subsystems
|
82
|
4043
|
|
4044 This is part 4 of the XEmacs Frequently Asked Questions list. This
|
|
4045 section is devoted to major XEmacs subsystems.
|
|
4046
|
|
4047 @menu
|
|
4048 Reading Mail with VM:
|
|
4049 * Q4.0.1:: How do I set up VM to retrieve remote mail using POP?
|
|
4050 * Q4.0.2:: How do I get VM to filter mail for me?
|
|
4051 * Q4.0.3:: How can I get VM to automatically check for new mail?
|
|
4052 * Q4.0.4:: [This question intentionally left blank]
|
|
4053 * Q4.0.5:: How do I get my outgoing mail archived?
|
|
4054 * Q4.0.6:: I have various addresses at which I receive mail. How can I tell VM to ignore them when doing a "reply-all"?
|
|
4055 * Q4.0.7:: Is there a mailing list or FAQ for VM?
|
217
|
4056 * Q4.0.8:: Remote mail reading with VM.
|
82
|
4057 * Q4.0.9:: rmail or VM gets an error incorporating new mail.
|
|
4058 * Q4.0.10:: How do I make VM stay in a single frame?
|
|
4059 * Q4.0.11:: How do I make VM or mh-e display graphical smilies?
|
|
4060 * Q4.0.12:: Customization of VM not covered in the manual or here.
|
|
4061
|
|
4062 Web browsing with W3:
|
|
4063 * Q4.1.1:: What is W3?
|
|
4064 * Q4.1.2:: How do I run W3 from behind a firewall?
|
163
|
4065 * Q4.1.3:: Is it true that W3 supports style sheets and tables?
|
82
|
4066
|
|
4067 Reading Netnews and Mail with Gnus:
|
282
|
4068 * Q4.2.1:: GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus,argh!
|
82
|
4069 * Q4.2.2:: [This question intentionally left blank]
|
|
4070 * Q4.2.3:: How do I make Gnus stay within a single frame?
|
|
4071 * Q4.2.4:: How do I customize the From: line?
|
|
4072
|
|
4073 Other Mail & News:
|
|
4074 * Q4.3.1:: How can I read and/or compose MIME messages?
|
|
4075 * Q4.3.2:: What is TM and where do I get it?
|
|
4076 * Q4.3.3:: Why isn't this @code{movemail} program working?
|
|
4077 * Q4.3.4:: Movemail is also distributed by Netscape? Can that cause problems?
|
|
4078 * Q4.3.5:: Where do I find pstogif (required by tm)?
|
|
4079
|
|
4080 Sparcworks, EOS, and WorkShop:
|
282
|
4081 * Q4.4.1:: What is SPARCworks, EOS, and WorkShop
|
82
|
4082
|
|
4083 Energize:
|
|
4084 * Q4.5.1:: What is/was Energize?
|
|
4085
|
|
4086 Infodock:
|
|
4087 * Q4.6.1:: What is Infodock?
|
|
4088
|
|
4089 Other Unbundled Packages:
|
163
|
4090 * Q4.7.1:: What is AUC TeX? Where do you get it?
|
82
|
4091 * Q4.7.2:: Are there any Emacs Lisp Spreadsheets?
|
163
|
4092 * Q4.7.3:: Byte compiling AUC TeX on XEmacs 19.14
|
|
4093 * Q4.7.4:: Problems installing AUC TeX
|
|
4094 * Q4.7.5:: Is there a reason for an Emacs package not to be included in XEmacs?
|
282
|
4095 * Q4.7.6:: Is there a MatLab mode?
|
82
|
4096 @end menu
|
|
4097
|
|
4098 @node Q4.0.1, Q4.0.2, Subsystems, Subsystems
|
282
|
4099 @unnumberedsec 4.0: Reading Mail with VM
|
274
|
4100 @unnumberedsubsec Q4.0.1: How do I set up VM to retrieve mail from a remote site using POP?
|
82
|
4101
|
|
4102 Use @code{vm-spool-files}, like this for example:
|
|
4103
|
|
4104 @lisp
|
|
4105 (setq vm-spool-files '("/var/spool/mail/wing"
|
|
4106 "netcom23.netcom.com:110:pass:wing:MYPASS"))
|
|
4107 @end lisp
|
|
4108
|
|
4109 Of course substitute your actual password for MYPASS.
|
|
4110
|
|
4111 @node Q4.0.2, Q4.0.3, Q4.0.1, Subsystems
|
274
|
4112 @unnumberedsubsec Q4.0.2: How do I get VM to filter mail for me?
|
82
|
4113
|
|
4114 One possibility is to use procmail to split your mail before it gets to
|
|
4115 VM. I prefer this personally, since there are many strange and
|
|
4116 wonderful things one can do with procmail. Procmail may be found at
|
274
|
4117 @uref{ftp://ftp.informatik.rwth-aachen.de/pub/packages/procmail/}.
|
82
|
4118
|
|
4119 Also see the Mail Filtering FAQ at:
|
274
|
4120 @iftex
|
|
4121 @*
|
282
|
4122 @end iftex
|
|
4123 @uref{ftp://rtfm.mit.edu/pub/usenet/news.answers/mail/filtering-faq}.
|
|
4124 @c Link above,
|
|
4125 @c <URL:http://www.cis.ohio-state.edu/hypertext/faq/usenet/mail/filtering-faq/faq.html>
|
|
4126 @c was dead.
|
82
|
4127
|
|
4128 @node Q4.0.3, Q4.0.4, Q4.0.2, Subsystems
|
274
|
4129 @unnumberedsubsec Q4.0.3: How can I get VM to automatically check for new mail?
|
|
4130
|
|
4131 @email{turner@@lanl.gov, John Turner} writes:
|
82
|
4132
|
|
4133 @quotation
|
|
4134 Use the following:
|
|
4135
|
|
4136 @lisp
|
|
4137 (setq vm-auto-get-new-mail 60)
|
|
4138 @end lisp
|
|
4139 @end quotation
|
|
4140
|
|
4141 @node Q4.0.4, Q4.0.5, Q4.0.3, Subsystems
|
274
|
4142 @unnumberedsubsec Q4.0.4: [This question intentionally left blank]
|
82
|
4143
|
|
4144 Obsolete question, left blank to avoid renumbering.
|
|
4145
|
|
4146 @node Q4.0.5, Q4.0.6, Q4.0.4, Subsystems
|
274
|
4147 @unnumberedsubsec Q4.0.5: How do I get my outgoing mail archived?
|
82
|
4148
|
|
4149 @lisp
|
|
4150 (setq mail-archive-file-name "~/outbox")
|
|
4151 @end lisp
|
|
4152
|
|
4153 @node Q4.0.6, Q4.0.7, Q4.0.5, Subsystems
|
274
|
4154 @unnumberedsubsec Q4.0.6: I have various addresses at which I receive mail. How can I tell VM to ignore them when doing a "reply-all"?
|
82
|
4155
|
|
4156 Set @code{vm-reply-ignored-addresses} to a list, like
|
|
4157
|
|
4158 @lisp
|
282
|
4159 (setq vm-reply-ignored-addresses
|
274
|
4160 '("wing@@nuspl@@nvwls.cc.purdue.edu,netcom[0-9]*.netcom.com"
|
|
4161 "wing@@netcom.com" "wing@@666.com"))
|
82
|
4162 @end lisp
|
|
4163
|
|
4164 Note that each string is a regular expression.
|
|
4165
|
|
4166 @node Q4.0.7, Q4.0.8, Q4.0.6, Subsystems
|
274
|
4167 @unnumberedsubsec Q4.0.7: Is there a mailing list or FAQ for VM?
|
|
4168
|
282
|
4169 A FAQ for VM exists at @uref{http://www.cyberpass.net/~gorkab/vmfaq.htm}.
|
82
|
4170
|
163
|
4171 VM has its own newsgroups gnu.emacs.vm.info and gnu.emacs.vm.bug.
|
82
|
4172
|
274
|
4173 @node Q4.0.8, Q4.0.9, Q4.0.7, Subsystems
|
|
4174 @unnumberedsubsec Q4.0.8: Remote mail reading with VM.
|
82
|
4175
|
|
4176 My mailbox lives at the office on a big honkin server. My regular INBOX
|
|
4177 lives on my honkin desktop machine. I now can PPP to the office from
|
|
4178 home which is far from honking... I'd like to be able to read mail at
|
|
4179 home without storing it here and I'd like to use xemacs and VM at
|
|
4180 home... Is there a recommended setup?
|
|
4181
|
274
|
4182 @email{nuspl@@nvwls.cc.purdue.edu, Joseph J. Nuspl Jr.} writes:
|
82
|
4183
|
|
4184 @quotation
|
|
4185 There are several ways to do this.
|
|
4186
|
|
4187 @enumerate
|
|
4188 @item
|
|
4189 Set your display to your home machine and run dxpc or one of the other X
|
|
4190 compressors.
|
|
4191
|
|
4192 @item
|
|
4193 NFS mount your desktop machine on your home machine and modify your pop
|
|
4194 command on your home machine to rsh to your desktop machine and actually
|
|
4195 do the pop get's.
|
|
4196
|
|
4197 @item
|
|
4198 Run a POP server on your desktop machine as well and do a sort of two
|
|
4199 tiered POP get.
|
|
4200 @end enumerate
|
|
4201 @end quotation
|
|
4202
|
274
|
4203 @email{wmperry@@monolith.spry.com, William Perry} adds:
|
82
|
4204
|
|
4205 @quotation
|
|
4206 Or you could run a pop script periodically on your desktop machine, and
|
|
4207 just use ange-ftp or NFS to get to your mailbox. I used to do this all
|
|
4208 the time back at IU.
|
|
4209 @end quotation
|
|
4210
|
|
4211 @node Q4.0.9, Q4.0.10, Q4.0.8, Subsystems
|
274
|
4212 @unnumberedsubsec Q4.0.9: rmail or VM gets an error incorporating new mail.
|
82
|
4213
|
163
|
4214 Quoting the XEmacs PROBLEMS file:
|
82
|
4215
|
|
4216 @quotation
|
|
4217 rmail and VM get new mail from @file{/usr/spool/mail/$USER} using a
|
|
4218 program called @code{movemail}. This program interlocks with
|
|
4219 @code{/bin/mail} using the protocol defined by @code{/bin/mail}.
|
282
|
4220
|
82
|
4221 There are two different protocols in general use. One of them uses the
|
|
4222 @code{flock} system call. The other involves creating a lock file;
|
|
4223 @code{movemail} must be able to write in @file{/usr/spool/mail} in order
|
|
4224 to do this. You control which one is used by defining, or not defining,
|
|
4225 the macro @code{MAIL_USE_FLOCK} in @file{config.h} or the m- or s- file
|
|
4226 it includes.
|
|
4227
|
|
4228 @strong{IF YOU DON'T USE THE FORM OF INTERLOCKING THAT IS NORMAL ON YOUR
|
|
4229 SYSTEM, YOU CAN LOSE MAIL!}
|
|
4230
|
|
4231 If your system uses the lock file protocol, and fascist restrictions
|
|
4232 prevent ordinary users from writing the lock files in
|
|
4233 @file{/usr/spool/mail}, you may need to make @code{movemail} setgid to a
|
|
4234 suitable group such as @samp{mail}. You can use these commands (as
|
|
4235 root):
|
|
4236
|
|
4237 @example
|
|
4238 chgrp mail movemail
|
|
4239 chmod 2755 movemail
|
|
4240 @end example
|
|
4241
|
|
4242 If your system uses the lock file protocol, and fascist restrictions
|
|
4243 prevent ordinary users from writing the lock files in
|
|
4244 @file{/usr/spool/mail}, you may need to make @code{movemail} setgid to a
|
|
4245 suitable group such as @code{mail}. To do this, use the following
|
|
4246 commands (as root) after doing the make install.
|
|
4247
|
|
4248 @example
|
|
4249 chgrp mail movemail
|
|
4250 chmod 2755 movemail
|
|
4251 @end example
|
|
4252
|
|
4253 Installation normally copies movemail from the build directory to an
|
|
4254 installation directory which is usually under @file{/usr/local/lib}.
|
|
4255 The installed copy of @code{movemail} is usually in the directory
|
|
4256 @file{/usr/local/lib/emacs/VERSION/TARGET}. You must change the group
|
|
4257 and mode of the installed copy; changing the group and mode of the build
|
|
4258 directory copy is ineffective.
|
|
4259 @end quotation
|
|
4260
|
|
4261 @node Q4.0.10, Q4.0.11, Q4.0.9, Subsystems
|
274
|
4262 @unnumberedsubsec Q4.0.10: How do I make VM stay in a single frame?
|
|
4263
|
|
4264 John.@email{Cooper@@Eng.Sun.COM, John S Cooper} writes:
|
82
|
4265
|
|
4266 @quotation
|
|
4267 @lisp
|
274
|
4268 ; Don't use multiple frames
|
82
|
4269 (setq vm-frame-per-composition nil)
|
|
4270 (setq vm-frame-per-folder nil)
|
|
4271 (setq vm-frame-per-edit nil)
|
|
4272 (setq vm-frame-per-summary nil)
|
|
4273 @end lisp
|
|
4274 @end quotation
|
|
4275
|
|
4276 @node Q4.0.11, Q4.0.12, Q4.0.10, Subsystems
|
274
|
4277 @unnumberedsubsec Q4.0.11: How do I make VM or mh-e display graphical smilies?
|
282
|
4278 @c Changed June
|
82
|
4279 For mh-e use the following:
|
|
4280
|
|
4281 @lisp
|
282
|
4282 (add-hook 'mh-show-mode-hook '(lambda ()
|
274
|
4283 (smiley-region (point-min)
|
|
4284 (point-max))))
|
82
|
4285 @end lisp
|
|
4286
|
282
|
4287 @email{bill@@carpenter.ORG, WJCarpenter} writes:
|
|
4288 For VM use the following:
|
82
|
4289 @lisp
|
282
|
4290 (autoload 'smiley-region "smiley" nil t)
|
|
4291 (add-hook 'vm-select-message-hook
|
|
4292 '(lambda ()
|
|
4293 (smiley-region (point-min)
|
|
4294 (point-max))))
|
82
|
4295 @end lisp
|
|
4296
|
|
4297 For tm use the following:
|
|
4298 @lisp
|
|
4299 (autoload 'smiley-buffer "smiley" nil t)
|
|
4300 (add-hook 'mime-viewer/plain-text-preview-hook 'smiley-buffer)
|
|
4301 @end lisp
|
|
4302
|
|
4303 @node Q4.0.12, Q4.1.1, Q4.0.11, Subsystems
|
274
|
4304 @unnumberedsubsec Q4.0.12: Customization of VM not covered in the manual, or here.
|
|
4305
|
|
4306 @email{boffi@@hp735.stru.polimi.it, giacomo boffi} writes:
|
82
|
4307
|
|
4308 @quotation
|
|
4309 The meta-answer is to look into the file @file{vm-vars.el}, in the vm
|
|
4310 directory of the lisp library.
|
|
4311
|
|
4312 @file{vm-vars.el} contains, initializes and carefully describes, with
|
|
4313 examples of usage, the plethora of user options that @emph{fully}
|
|
4314 control VM's behavior.
|
|
4315
|
|
4316 Enter vm-vars, @code{forward-search} for toolbar, find the variables
|
|
4317 that control the toolbar placement, appearance, existence, copy to your
|
|
4318 @file{.emacs} or @file{.vm} and modify according to the detailed
|
|
4319 instructions.
|
|
4320
|
|
4321 The above also applies to all the various features of VM: search for
|
|
4322 some keywords, maybe the first you conjure isn't appropriate, find the
|
|
4323 appropriate variables, copy and experiment.
|
|
4324 @end quotation
|
|
4325
|
|
4326 @node Q4.1.1, Q4.1.2, Q4.0.12, Subsystems
|
282
|
4327 @unnumberedsec 4.1: Web browsing with W3
|
274
|
4328 @unnumberedsubsec Q4.1.1: What is W3?
|
82
|
4329
|
|
4330 W3 is an advanced graphical browser written in Emacs lisp that runs on
|
|
4331 XEmacs. It has full support for cascaded style sheets, and more...
|
|
4332
|
|
4333 It has a home web page at
|
274
|
4334 @uref{http://www.cs.indiana.edu/elisp/w3/docs.html}.
|
82
|
4335
|
163
|
4336 @node Q4.1.2, Q4.1.3, Q4.1.1, Subsystems
|
274
|
4337 @unnumberedsubsec Q4.1.2: How do I run W3 from behind a firewall?
|
82
|
4338
|
|
4339 There is a long, well-written, detailed section in the W3 manual that
|
|
4340 describes how to do this. Look in the section entitled "Firewalls".
|
|
4341
|
163
|
4342 @node Q4.1.3, Q4.2.1, Q4.1.2, Subsystems
|
274
|
4343 @unnumberedsubsec Q4.1.3: Is it true that W3 supports style sheets and tables?
|
163
|
4344
|
|
4345 Yes, and much more. W3, as distributed with the latest XEmacs is a
|
|
4346 full-featured web browser.
|
|
4347
|
|
4348 @node Q4.2.1, Q4.2.2, Q4.1.3, Subsystems
|
282
|
4349 @unnumberedsec 4.2: Reading Netnews and Mail with Gnus
|
274
|
4350 @unnumberedsubsec Q4.2.1: GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus, Quassia Gnus, argh!
|
82
|
4351
|
163
|
4352 The Gnus numbering issues are not meant for mere mortals to know them.
|
|
4353 If you feel you @emph{must} enter the muddy waters of Gnus, visit the
|
|
4354 excellent FAQ, maintained by Justin Sheehy, at:
|
|
4355
|
|
4356 @example
|
282
|
4357 @uref{http://www.ccs.neu.edu/software/contrib/gnus/}
|
163
|
4358 @end example
|
82
|
4359
|
215
|
4360 See also Gnus home page
|
|
4361 @example
|
274
|
4362 @uref{http://www.gnus.org/}
|
215
|
4363 @end example
|
|
4364
|
82
|
4365 @node Q4.2.2, Q4.2.3, Q4.2.1, Subsystems
|
274
|
4366 @unnumberedsubsec Q4.2.2: This question intentionally left blank.
|
82
|
4367
|
|
4368 Obsolete question, left blank to avoid renumbering.
|
|
4369
|
|
4370 @node Q4.2.3, Q4.2.4, Q4.2.2, Subsystems
|
274
|
4371 @unnumberedsubsec Q4.2.3: How do I make Gnus stay within a single frame?
|
82
|
4372
|
163
|
4373 The toolbar code to start Gnus opens the new frame---and it's a feature
|
|
4374 rather than a bug. If you don't like it, but would still like to click
|
|
4375 on the seemly icon, use the following code:
|
82
|
4376
|
|
4377 @lisp
|
|
4378 (defun toolbar-news ()
|
|
4379 (gnus))
|
|
4380 @end lisp
|
163
|
4381
|
|
4382 It will redefine the callback function of the icon to just call
|
|
4383 @code{gnus}, without all the fancy frame stuff.
|
82
|
4384
|
|
4385 @node Q4.2.4, Q4.3.1, Q4.2.3, Subsystems
|
274
|
4386 @unnumberedsubsec Q4.2.4: How do I customize the From: line?
|
82
|
4387
|
|
4388 How do I change the @code{From:} line? I have set gnus-user-from-line
|
282
|
4389 to
|
|
4390 @example
|
274
|
4391 Gail Gurman <gail.gurman@@sybase.com>
|
|
4392 @end example
|
|
4393 @noindent , but XEmacs Gnus doesn't use
|
282
|
4394 it. Instead it uses
|
|
4395 @example
|
|
4396 Gail Mara Gurman @email{gailg@@deall}
|
274
|
4397 @end example
|
|
4398 @noindent and then complains
|
82
|
4399 that it's incorrect. Also, as you perhaps can see, my Message-ID is
|
|
4400 screwy. How can I change that?
|
|
4401
|
274
|
4402 @email{larsi@@ifi.uio.no, Lars Magne Ingebrigtsen} writes:
|
82
|
4403
|
|
4404 @quotation
|
|
4405 Set @code{user-mail-address} to @samp{gail.gurman@@sybase.com} or
|
|
4406 @code{mail-host-address} to @samp{sybase.com}.
|
|
4407 @end quotation
|
|
4408
|
|
4409 @node Q4.3.1, Q4.3.2, Q4.2.4, Subsystems
|
282
|
4410 @unnumberedsec 4.3: Other Mail & News
|
274
|
4411 @unnumberedsubsec Q4.3.1: How can I read and/or compose MIME messages?
|
282
|
4412 @c Changed June
|
|
4413
|
|
4414 VM supports MIME natively.
|
82
|
4415
|
|
4416 You probably want to use the Tools for MIME (tm). @xref{Q4.3.2} for
|
|
4417 details.
|
|
4418
|
274
|
4419 @email{trey@@cs.berkeley.edu, Trey Jackson} has an Emacs & MIME web page at
|
|
4420 @iftex
|
|
4421 @*
|
282
|
4422 @end iftex
|
274
|
4423 @uref{http://bmrc.berkeley.edu/~trey/emacs/mime.html}.
|
82
|
4424
|
282
|
4425
|
|
4426 Another possibility is RMIME. You may find RMIME at
|
|
4427 @iftex
|
|
4428 @*
|
|
4429 @end iftex
|
|
4430 @uref{http://www.cinti.net/~rmoody/rmime/index.html}.
|
|
4431
|
|
4432
|
82
|
4433 @node Q4.3.2, Q4.3.3, Q4.3.1, Subsystems
|
274
|
4434 @unnumberedsubsec Q4.3.2: What is TM and where do I get it?
|
82
|
4435
|
|
4436 TM stands for @dfn{Tools for MIME} and not Tiny MIME. TM integrates
|
|
4437 with all major XEmacs packages like Gnus (all flavors), VM, MH-E, and
|
|
4438 mailcrypt. It provides totally transparent and trouble-free MIME
|
|
4439 support. When appropriate a message will be decoded in place in an
|
|
4440 XEmacs buffer.
|
|
4441
|
213
|
4442 TM now comes as a package with XEmacs 19.16 and XEmacs 20.2.
|
126
|
4443
|
274
|
4444 TM was written by @email{morioka@@jaist.ac.jp, MORIOKA Tomohiko} and
|
|
4445 @email{shuhei-k@@jaist.ac.jp, KOBAYASHI
|
282
|
4446 Shuhei}.
|
274
|
4447
|
|
4448 It is based on the work of @email{umerin@@mse.kyutech.ac.jp, UMEDA
|
|
4449 Masanobu}, the original writer of GNUS.
|
82
|
4450
|
|
4451 The following information is from the @file{README}:
|
|
4452
|
|
4453 @dfn{tm} is a MIME package for GNU Emacs.
|
|
4454 tm has following functions:
|
|
4455
|
|
4456 @itemize @bullet
|
|
4457 @item MIME style multilingual header.
|
|
4458 @item MIME message viewer (mime/viewer-mode).
|
|
4459 @item MIME message composer (mime/editor-mode).
|
|
4460 @item MIME extenders for mh-e, GNUS, RMAIL and VM.
|
|
4461 @end itemize
|
|
4462
|
|
4463 tm is available from following anonymous ftp sites:
|
|
4464 @itemize @bullet
|
274
|
4465 @item @uref{ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/} (Japan).
|
|
4466 @item @uref{ftp://ftp.nis.co.jp/pub/gnu/emacs-lisp/tm/} (Japan).
|
282
|
4467 @c The host above is unknown.
|
|
4468
|
274
|
4469 @item @uref{ftp://ftp.nisiq.net/pub/gnu/emacs-lisp/tm/} (US).
|
|
4470 @item @uref{ftp://ftp.miranova.com/pub/gnus/jaist.ac.jp/} (US).
|
|
4471 @item @uref{ftp://ftp.unicamp.br/pub/mail/mime/tm/} (Brasil).
|
|
4472 @item @uref{ftp://ftp.th-darmstadt.de/pub/editors/GNU-Emacs/lisp/mime/} (Germany).
|
|
4473 @item @uref{ftp://ftp.tnt.uni-hannover.de/pub/editors/xemacs/contrib/} (Germany).
|
82
|
4474 @end itemize
|
|
4475
|
|
4476 Don't let the installation procedure & instructions stop you from trying
|
|
4477 this package out---it's much simpler than it looks, and once installed,
|
|
4478 trivial to use.
|
|
4479
|
|
4480 @node Q4.3.3, Q4.3.4, Q4.3.2, Subsystems
|
274
|
4481 @unnumberedsubsec Q4.3.3: Why isn't this @code{movemail} program working?
|
|
4482
|
|
4483 Ben Wing @email{ben@@666.com} writes:
|
82
|
4484
|
|
4485 @quotation
|
|
4486 It wasn't chown'ed/chmod'd correctly.
|
|
4487 @end quotation
|
|
4488
|
|
4489 @node Q4.3.4, Q4.3.5, Q4.3.3, Subsystems
|
274
|
4490 @unnumberedsubsec Q4.3.4: Movemail is also distributed by Netscape? Can that cause problems?
|
|
4491
|
|
4492 @email{steve@@altair.xemacs.org, Steve Baur} writes:
|
82
|
4493
|
|
4494 @quotation
|
|
4495 Yes. Always use the movemail installed with your XEmacs. Failure to do
|
|
4496 so can result in lost mail.
|
|
4497 @end quotation
|
|
4498
|
274
|
4499 Please refer to @email{jwz@@netscape.com, Jamie Zawinski's} notes at
|
|
4500 @iftex
|
|
4501 @*
|
282
|
4502 @end iftex
|
274
|
4503 @uref{http://home.netscape.com/eng/mozilla/2.0/relnotes/demo/movemail.html}.
|
82
|
4504 In particular, this document will show you how to make Netscape use the
|
|
4505 version of movemail configured for your system by the person who built
|
|
4506 XEmacs.
|
|
4507
|
|
4508 @node Q4.3.5, Q4.4.1, Q4.3.4, Subsystems
|
274
|
4509 @unnumberedsubsec Q4.3.5: Where do I find pstogif (required by tm)?
|
82
|
4510
|
|
4511 pstogif is part of the latex2html package.
|
|
4512
|
274
|
4513 @email{vroonhof@@math.ethz.ch, Jan Vroonhof} writes:
|
82
|
4514
|
|
4515 latex2html is best found at the CTAN hosts and their mirrors
|
282
|
4516 in
|
274
|
4517 @iftex
|
|
4518 @*
|
282
|
4519 @end iftex
|
274
|
4520 @file{tex-archive/support/latex2html}.
|
82
|
4521
|
|
4522 CTAN hosts are:
|
|
4523
|
|
4524 @itemize @bullet
|
274
|
4525 @item @uref{ftp://ftp.tex.ac.uk/tex-archive/support/latex2html/}.
|
|
4526 @item @uref{ftp://ftp.dante.de/tex-archive/support/latex2html/}.
|
82
|
4527 @end itemize
|
|
4528
|
|
4529 There is a good mirror at ftp.cdrom.com;
|
274
|
4530 @iftex
|
|
4531 @*
|
282
|
4532 @end iftex
|
274
|
4533 @uref{ftp://ftp.cdrom.com/pub/tex/ctan/support/latex2html/}.
|
82
|
4534
|
|
4535 @node Q4.4.1, Q4.5.1, Q4.3.5, Subsystems
|
282
|
4536 @unnumberedsec 4.4: Sparcworks, EOS, and WorkShop
|
274
|
4537 @unnumberedsubsec Q4.4.1: What is SPARCworks, EOS, and WorkShop?
|
|
4538
|
|
4539 @email{turner@@lanl.gov, John Turner} writes:
|
82
|
4540
|
|
4541 @quotation
|
|
4542 SPARCworks is SunSoft's development environment, comprising compilers
|
|
4543 (C, C++, FORTRAN 77, Fortran 90, Ada, and Pascal), a debugger, and other
|
|
4544 tools such as TeamWare (for configuration management), MakeTool, etc.
|
|
4545 @end quotation
|
|
4546
|
282
|
4547 See @uref{http://www.sun.com/software/Developer-products/}
|
82
|
4548 for more info.
|
|
4549
|
|
4550 EOS stands for "Era on SPARCworks", but I don't know what Era stands
|
|
4551 for.
|
|
4552
|
|
4553 EOS is the integration of XEmacs with the SPARCworks debugger. It
|
|
4554 allows one to use an XEmacs frame to view code (complete with
|
|
4555 fontification, etc.), set breakpoints, print variables, etc., while
|
|
4556 using the SPARCworks debugger. It works very well and I use it all the
|
|
4557 time.
|
|
4558
|
274
|
4559 @email{cthomp@@xemacs.org, Chuck Thompson} writes:
|
82
|
4560
|
|
4561 @quotation
|
|
4562 Era stood for "Emacs Rewritten Again". It was what we were calling the
|
|
4563 modified version of Lucid Emacs for Sun when I was dragged, er, allowed
|
|
4564 to work on this wonderful editor.
|
|
4565 @end quotation
|
|
4566
|
274
|
4567 @email{martin@@xemacs.org, Martin Buchholz} writes:
|
82
|
4568
|
|
4569 @quotation
|
|
4570 EOS is being replaced with a new graphical development environment
|
|
4571 called Sun WorkShop, which is currently (07/96) in Alpha Test. For more
|
|
4572 details, check out
|
274
|
4573 @iftex
|
|
4574 @*
|
282
|
4575 @end iftex
|
|
4576 @uref{http://www.sun.com/software/Products/Developer-products/programs.html}.
|
82
|
4577 @end quotation
|
|
4578
|
|
4579 @node Q4.5.1, Q4.6.1, Q4.4.1, Subsystems
|
282
|
4580 @unnumberedsec 4.5: Energize
|
274
|
4581 @unnumberedsubsec Q4.5.1: What is/was Energize?
|
|
4582
|
|
4583 @email{gray@@meteor.harlequin.com, David N Gray} writes:
|
82
|
4584 @quotation
|
|
4585 The files in @file{lisp/energize} are to enable Emacs to interface with
|
|
4586 the "Energize Programming System", a C and C++ development environment,
|
|
4587 which was a product of Lucid, Inc. Tragically, Lucid went out of
|
|
4588 business in 1994, so although Energize is still a great system, if you
|
|
4589 don't already have it, there isn't any way to get it now. (Unless you
|
|
4590 happen to be in Japan; INS Engineering may still be selling it there.
|
|
4591 Tartan bought the rights to sell it in the rest of the world, but never
|
|
4592 did so.)
|
|
4593 @end quotation
|
|
4594
|
|
4595 @node Q4.6.1, Q4.7.1, Q4.5.1, Subsystems
|
282
|
4596 @unnumberedsec 4.6: Infodock
|
274
|
4597 @unnumberedsubsec Q4.6.1: What is Infodock?
|
82
|
4598
|
0
|
4599 InfoDock is an integrated productivity toolset, mainly aimed at
|
86
|
4600 technical people. It is developed and supported by InfoDock
|
|
4601 Associates, a firm that offers custom support and development
|
274
|
4602 for InfoDock, XEmacs and GNU Emacs. ( @uref{http://www.infodock.com},
|
|
4603 @email{info@@infodock.com}, +1 408 243 3300).
|
86
|
4604
|
|
4605 InfoDock is built atop the XEmacs variant of GNU Emacs and so has all of
|
|
4606 the power of Emacs, but with an easier to use and more comprehensive
|
|
4607 menu-based user interface. The bottom portion of this text describes
|
|
4608 how it differs from XEmacs and GNU Emacs from the Free Software
|
|
4609 Foundation.
|
0
|
4610
|
|
4611 InfoDock is aimed at people who want a free, turn-key productivity
|
|
4612 environment. Although InfoDock is customizable, it is not intended for
|
|
4613 people who like basic versions of Emacs which need to be customized
|
|
4614 extensively for local use; standard Emacs distributions are better for
|
|
4615 such uses. InfoDock is for those people who want a complete,
|
|
4616 pre-customized environment in one package, which they need not touch
|
|
4617 more than once or twice a year to update to new revisions.
|
|
4618
|
86
|
4619 InfoDock is pre-built for SPARC SunOS/Solaris systems, PA-RISC HP-UX,
|
|
4620 and Intel Linux systems. It is intended for use on a color display,
|
|
4621 although most features will work on monochrome monitors. Simply unpack
|
|
4622 InfoDock according to the instructions in the ID-INSTALL file and you
|
|
4623 are ready to run.
|
0
|
4624
|
|
4625 The InfoDock Manual is concise, yet sufficient as a user guide for users
|
|
4626 who have never used an Emacs-type editor before. For users who are
|
|
4627 already familiar with Emacs, it supplements the information in the GNU
|
|
4628 Emacs Manual.
|
|
4629
|
|
4630 InfoDock menus are much more extensive and more mature than standard
|
86
|
4631 Emacs menus. Each menu offers a @samp{Manual} item which displays
|
0
|
4632 documentation associated with the menu's functions.
|
282
|
4633
|
86
|
4634 @noindent
|
|
4635 Four types of menubars are provided:
|
0
|
4636 @enumerate
|
|
4637 @item
|
|
4638 An extensive menubar providing access to global InfoDock commands.
|
|
4639 @item
|
|
4640 Mode-specific menubars tailored to the current major mode.
|
|
4641 @item
|
86
|
4642 A simple menubar for basic editing to help novices get started with InfoDock.
|
|
4643 @item
|
|
4644 The standard XEmacs menubar.
|
0
|
4645 @end enumerate
|
|
4646
|
86
|
4647 Most modes also include mode-specific popup menus. Additionally, region and
|
|
4648 rectangle popup menus are included.
|
|
4649
|
|
4650 @samp{Hyperbole}, the everyday information manager, is a core part of
|
0
|
4651 InfoDock. This provides context-sensitive mouse keys, a rolodex-type
|
|
4652 contact manager, programmable hypertext buttons, and an autonumbered
|
|
4653 outliner with embedded hyperlink anchors.
|
82
|
4654
|
86
|
4655 The @samp{OO-Browser}, a multi-language object-oriented code browser, is a
|
|
4656 standard part of InfoDock.
|
0
|
4657
|
|
4658 InfoDock saves a more extensive set of user options than other Emacs
|
|
4659 versions.
|
|
4660
|
|
4661 InfoDock inserts a useful file header in many file types, showing the
|
|
4662 author, summary, and last modification time of each file. A summary
|
|
4663 program can then be used to summarize all of the files in a directory,
|
|
4664 for easy MANIFEST file creation.
|
|
4665
|
|
4666 Your working set of buffers is automatically saved and restored (if you
|
|
4667 answer yes to a prompt) between InfoDock sessions.
|
|
4668
|
86
|
4669 Refined color choices for code highlighting are provided for both dark and
|
|
4670 light background display frames.
|
|
4671
|
|
4672 The @kbd{C-z} key prefix performs frame-based commands which parallel the
|
|
4673 @kbd{C-x} key prefix for window-based commands.
|
0
|
4674
|
|
4675 The Smart Menu system is included for producing command menus on dumb
|
86
|
4676 terminals.
|
0
|
4677
|
|
4678 Lisp libraries are better categorized according to function.
|
|
4679
|
86
|
4680 Extensions and improvements to many areas of Emacs are included, such as:
|
|
4681 paragraph filling, mail reading with Rmail, shell handling, outlining, code
|
|
4682 highlighting and browsing, and man page browsing.
|
0
|
4683
|
|
4684 InfoDock questions, answers and discussion should go to the mail list
|
274
|
4685 @iftex
|
|
4686 @*
|
282
|
4687 @end iftex
|
274
|
4688 @email{infodock@@infodock.com}. Use
|
|
4689 @email{infodock-request@@infodock.com} to be added or removed from the
|
86
|
4690 list. Always include your InfoDock version number when sending help
|
|
4691 requests.
|
|
4692
|
|
4693 InfoDock is available across the Internet via anonymous FTP. To get
|
|
4694 it, first move to a directory into which you want the InfoDock archive
|
|
4695 files placed. We will call this <DIST-DIR>.
|
282
|
4696
|
86
|
4697 @example
|
|
4698 cd <DIST-DIR>
|
|
4699 @end example
|
|
4700
|
|
4701 Ftp to ftp.xemacs.org (Internet Host ID = 128.174.252.16):
|
82
|
4702
|
0
|
4703 @example
|
86
|
4704 prompt> ftp ftp.xemacs.org
|
0
|
4705 @end example
|
|
4706
|
86
|
4707 Login as @samp{anonymous} with your own <user-id>@@<site-name> as a password.
|
|
4708
|
282
|
4709 @example
|
86
|
4710 Name (ftp.xemacs.org): anonymous
|
|
4711 331 Guest login ok, send your complete e-mail address as password.
|
274
|
4712 Password: -<your-user-id>@@<your-domain>
|
86
|
4713 230 Guest login ok, access restrictions apply.
|
0
|
4714 @end example
|
|
4715
|
|
4716 Move to the location of the InfoDock archives:
|
|
4717
|
|
4718 @example
|
86
|
4719 ftp> cd pub/infodock
|
0
|
4720 @end example
|
|
4721
|
|
4722 Set your transfer mode to binary:
|
|
4723
|
|
4724 @example
|
86
|
4725 ftp> bin
|
|
4726 200 Type set to I.
|
0
|
4727 @end example
|
|
4728
|
|
4729 Turn off prompting:
|
|
4730
|
|
4731 @example
|
86
|
4732 ftp> prompt
|
|
4733 Interactive mode off.
|
0
|
4734 @end example
|
|
4735
|
|
4736 Retrieve the InfoDock archives that you want, either by using a
|
86
|
4737 @samp{get <file>} for each file you want or by using the following to
|
0
|
4738 get a complete distribution, including all binaries:
|
|
4739
|
|
4740 @example
|
86
|
4741 ftp> mget ID-INSTALL
|
|
4742 ftp> mget id-*
|
0
|
4743 @end example
|
|
4744
|
|
4745 Close the FTP connection:
|
|
4746
|
|
4747 @example
|
86
|
4748 ftp> quit
|
|
4749 221 Goodbye.
|
0
|
4750 @end example
|
|
4751
|
|
4752 Read the @file{ID-INSTALL} file which you just retrieved for
|
|
4753 step-by-step installation instructions.
|
|
4754
|
82
|
4755 @node Q4.7.1, Q4.7.2, Q4.6.1, Subsystems
|
282
|
4756 @unnumberedsec 4.7: Other Unbundled Packages
|
274
|
4757 @unnumberedsubsec Q4.7.1: What is AUC TeX? Where do you get it?
|
|
4758
|
|
4759 AUC TeX is a package written by @email{abraham@@dina.kvl.dk, Per Abrahamsen}.
|
213
|
4760 Starting with XEmacs 19.16, AUC TeX is bundled with XEmacs. The
|
163
|
4761 following information is from the @file{README} and website.
|
82
|
4762
|
|
4763 AUC TeX is an extensible package that supports writing and formatting
|
|
4764 TeX files for most variants of GNU Emacs. Many different macro packages
|
|
4765 are supported, including AMS TeX, LaTeX, and TeXinfo.
|
|
4766
|
|
4767 The most recent version is always available by ftp at
|
274
|
4768 @iftex
|
|
4769 @*
|
282
|
4770 @end iftex
|
274
|
4771 @uref{ftp://sunsite.auc.dk/packages/auctex/auctex.tar.gz}.
|
82
|
4772
|
|
4773 In case you don't have access to anonymous ftp, you can get it by an
|
274
|
4774 email request to @email{ftpmail@@decwrl.dec.com}.
|
82
|
4775
|
|
4776 WWW users may want to check out the AUC TeX page at
|
274
|
4777 @iftex
|
|
4778 @*
|
282
|
4779 @end iftex
|
274
|
4780 @uref{http://sunsite.auc.dk/auctex/}.
|
82
|
4781
|
|
4782 @node Q4.7.2, Q4.7.3, Q4.7.1, Subsystems
|
274
|
4783 @unnumberedsubsec Q4.7.2: Are there any Emacs Lisp Spreadsheets?
|
82
|
4784
|
|
4785 Yes. Check out @dfn{dismal} (which stands for Dis' Mode Ain't Lotus) at
|
274
|
4786 @iftex
|
|
4787 @*
|
282
|
4788 @end iftex
|
274
|
4789 @uref{ftp://cs.nyu.edu/pub/local/fox/dismal/}.
|
82
|
4790
|
|
4791 @node Q4.7.3, Q4.7.4, Q4.7.2, Subsystems
|
274
|
4792 @unnumberedsubsec Q4.7.3: Byte compiling AUC TeX on XEmacs 19.14.
|
|
4793
|
|
4794 @email{bruncott@@dormeur.inria.fr, Georges Brun-Cottan} writes:
|
82
|
4795
|
|
4796 @quotation
|
282
|
4797 When byte compiling auctex-9.4g, you must use the command:
|
0
|
4798
|
|
4799 @example
|
82
|
4800 xemacs -batch -l lpath.el
|
0
|
4801 @end example
|
82
|
4802 @end quotation
|
|
4803
|
163
|
4804 @node Q4.7.4, Q4.7.5, Q4.7.3, Subsystems
|
274
|
4805 @unnumberedsubsec Q4.7.4: Problems installing AUC TeX.
|
|
4806
|
|
4807 @email{vroonhof@@math.ethz.ch, Jan Vroonhof} writes:
|
82
|
4808
|
|
4809 @quotation
|
163
|
4810 AUC TeX works fine on both stock Emacs and XEmacs has been doing so for
|
274
|
4811 a very very long time. This is mostly due to the work of
|
|
4812 @email{abraham@@dina.kvl.dk, Per Abrahamsen} (clap clap) in particular his @file{easymenu}
|
82
|
4813 package. Which leads to what is probably the problem...
|
|
4814 @end quotation
|
|
4815
|
163
|
4816 Most problems with AUC TeX are one of two things:
|
0
|
4817
|
|
4818 @itemize @bullet
|
|
4819 @item
|
82
|
4820 The TeX-lisp-directory in @file{tex-site.el} and the makefile don't
|
|
4821 match.
|
|
4822
|
163
|
4823 Fix: make sure you configure AUC TeX properly @strong{before} installing.
|
82
|
4824
|
54
|
4825 @item
|
82
|
4826 You have an old version of easymenu.el in your path.
|
|
4827
|
|
4828 Fix: use @code{locate-library} and remove old versions to make sure it
|
|
4829 @strong{only} finds the one that came with XEmacs.
|
70
|
4830 @end itemize
|
|
4831
|
163
|
4832
|
282
|
4833 @node Q4.7.5, Q4.7.6, Q4.7.4, Subsystems
|
274
|
4834 @unnumberedsubsec Q4.7.5: Is there a reason for an Emacs package not to be included in XEmacs?
|
163
|
4835
|
|
4836 The reason for an Emacs package not to be included in XEmacs is
|
|
4837 usually one or more of the following:
|
|
4838
|
|
4839 @enumerate
|
|
4840 @item
|
|
4841 The package has not been ported to XEmacs. This will typically happen
|
|
4842 when it uses GNU-Emacs-specific features, which make it fail under
|
|
4843 XEmacs.
|
|
4844
|
|
4845 Porting a package to XEmacs can range from a trivial amount of change to
|
|
4846 a partial or full rewrite. Fortunately, the authors of modern packages
|
|
4847 usually choose to support both Emacsen themselves.
|
|
4848
|
|
4849 @item
|
|
4850 The package has been decided not to be appropriate for XEmacs. It may
|
|
4851 have an equivalent or better replacement within XEmacs, in which case
|
|
4852 the developers may choose not to burden themselves with supporting an
|
|
4853 additional package.
|
|
4854
|
|
4855 Each package bundled with XEmacs means more work for the maintainers,
|
|
4856 whether they want it or not. If you are ready to take over the
|
217
|
4857 maintenance responsibilities for the package you port, be sure to say
|
163
|
4858 so -- we will more likely include it.
|
|
4859
|
|
4860 @item
|
|
4861 The package simply hasn't been noted by the XEmacs development. If
|
|
4862 that's the case, the messages like yours are very useful for attracting
|
|
4863 our attention.
|
|
4864
|
|
4865 @item
|
|
4866 The package was noted by the developers, but they simply haven't yet
|
|
4867 gotten around to including/porting it. Wait for the next release or,
|
|
4868 even better, offer your help. It will be gladly accepted and
|
|
4869 appreciated.
|
|
4870 @end enumerate
|
|
4871
|
282
|
4872 @node Q4.7.6, , Q4.7.5, Subsystems
|
|
4873 @unnumberedsubsec Q4.7.5: Is there a MatLab mode?
|
|
4874 @c New
|
|
4875 Is there any way I can get syntax highlighting for MatLab .m files?
|
|
4876 Can I "teach" emacs what words are MatLab commands, comments, etc. ?
|
|
4877
|
|
4878 @email{elsner@@mathematik.tu-chemnitz.de, Ulrich Elsner} writes:
|
|
4879 @quotation
|
|
4880 One way to do this (and much more) is by using the
|
|
4881 @iftex
|
|
4882 @*
|
|
4883 @end iftex
|
|
4884 @uref{ftp://ftp.mathworks.com/pub/contrib/v5/tools/matlab.el, matlab mode}.
|
|
4885
|
|
4886 Instructions on how to install this mode are included in this file.
|
|
4887 @end quotation
|
|
4888
|
|
4889
|
82
|
4890 @node Miscellaneous, Current Events, Subsystems, Top
|
274
|
4891 @unnumbered 5 The Miscellaneous Stuff
|
82
|
4892
|
|
4893 This is part 5 of the XEmacs Frequently Asked Questions list. This
|
|
4894 section is devoted to anything that doesn't fit neatly into the other
|
|
4895 sections.
|
70
|
4896
|
|
4897 @menu
|
82
|
4898 Major & Minor Modes:
|
|
4899 * Q5.0.1:: How can I do source code highlighting using font-lock?
|
|
4900 * Q5.0.2:: I do not like cc-mode. How do I use the old c-mode?
|
|
4901 * Q5.0.3:: How do I get @samp{More} Syntax Highlighting on by default?
|
|
4902 * Q5.0.4:: How can I enable auto-indent?
|
|
4903 * Q5.0.5:: How can I get XEmacs to come up in text/auto-fill mode by default?
|
|
4904 * Q5.0.6:: How do I start up a second shell buffer?
|
|
4905 * Q5.0.7:: Telnet from shell filters too much.
|
|
4906 * Q5.0.8:: Why does edt emulation not work?
|
|
4907 * Q5.0.9:: How can I emulate VI and use it as my default mode?
|
282
|
4908 * Q5.0.10:: [This question intentionally left blank]
|
|
4909 * Q5.0.11:: Filladapt doesn't work in 19.15?
|
82
|
4910 * Q5.0.12:: How do I disable gnuserv from opening a new frame?
|
|
4911 * Q5.0.13:: How do I start gnuserv so that each subsequent XEmacs is a client?
|
|
4912 * Q5.0.14:: Strange things are happening in Shell Mode.
|
|
4913 * Q5.0.15:: Where do I get the latest CC Mode?
|
|
4914 * Q5.0.16:: I find auto-show-mode disconcerting. How do I turn it off?
|
|
4915 * Q5.0.17:: How can I get two instances of info?
|
|
4916 * Q5.0.18:: I upgraded to XEmacs 19.14 and gnuserv stopped working
|
|
4917 * Q5.0.19:: Is there something better than LaTeX mode?
|
274
|
4918 * Q5.0.20:: Is there a way to start a new XEmacs if there's no gnuserv running, and otherwise use gnuclient?
|
82
|
4919
|
|
4920 Emacs Lisp Programming Techniques:
|
|
4921 * Q5.1.1:: The difference in key sequences between XEmacs and GNU Emacs?
|
|
4922 * Q5.1.2:: Can I generate "fake" keyboard events?
|
163
|
4923 * Q5.1.3:: Could you explain @code{read-kbd-macro} in more detail?
|
|
4924 * Q5.1.4:: What is the performance hit of @code{let}?
|
|
4925 * Q5.1.5:: What is the recommended use of @code{setq}?
|
213
|
4926 * Q5.1.6:: What is the typical misuse of @code{setq}?
|
163
|
4927 * Q5.1.7:: I like the the @code{do} form of cl, does it slow things down?
|
|
4928 * Q5.1.8:: I like recursion, does it slow things down?
|
|
4929 * Q5.1.9:: How do I put a glyph as annotation in a buffer?
|
213
|
4930 * Q5.1.10:: @code{map-extents} won't traverse all of my extents!
|
282
|
4931 * Q5.1.11:: My elisp program is horribly slow. Is there an easy way to find out where it spends time?
|
82
|
4932
|
|
4933 Sound:
|
|
4934 * Q5.2.1:: How do I turn off the sound?
|
163
|
4935 * Q5.2.2:: How do I get funky sounds instead of a boring beep?
|
82
|
4936 * Q5.2.3:: What's NAS, how do I get it?
|
|
4937 * Q5.2.4:: Sunsite sounds don't play.
|
|
4938
|
|
4939 Miscellaneous:
|
|
4940 * Q5.3.1:: How do you make XEmacs indent CL if-clauses correctly?
|
|
4941 * Q5.3.2:: Fontifying hangs when editing a postscript file.
|
|
4942 * Q5.3.3:: How can I print WYSIWYG a font-locked buffer?
|
|
4943 * Q5.3.4:: Getting @kbd{M-x lpr} to work with postscript printer.
|
|
4944 * Q5.3.5:: How do I specify the paths that XEmacs uses for finding files?
|
|
4945 * Q5.3.6:: [This question intentionally left blank]
|
|
4946 * Q5.3.7:: Can I have the end of the buffer delimited in some way?
|
|
4947 * Q5.3.8:: How do I insert today's date into a buffer?
|
|
4948 * Q5.3.9:: Are only certain syntactic character classes available for abbrevs?
|
|
4949 * Q5.3.10:: How can I get those oh-so-neat X-Face lines?
|
|
4950 * Q5.3.11:: How do I add new Info directories?
|
|
4951 * Q5.3.12:: What do I need to change to make printing work?
|
70
|
4952 @end menu
|
|
4953
|
82
|
4954 @node Q5.0.1, Q5.0.2, Miscellaneous, Miscellaneous
|
282
|
4955 @unnumberedsec 5.0: Major & Minor Modes
|
274
|
4956 @unnumberedsubsec Q5.0.1: How can I do source code highlighting using font-lock?
|
82
|
4957
|
|
4958 For most modes, font-lock is already set up and just needs to be turned
|
|
4959 on. This can be done by @kbd{M-x font-lock-mode}, or by having XEmacs
|
|
4960 automatically start it by adding lines like:
|
|
4961
|
|
4962 @lisp
|
|
4963 (add-hook 'emacs-lisp-mode-hook 'turn-on-font-lock)
|
|
4964 (add-hook 'dired-mode-hook 'turn-on-font-lock)
|
|
4965 @end lisp
|
|
4966
|
|
4967 to your @file{.emacs}. See the file @file{etc/sample.emacs} for more
|
|
4968 examples.
|
|
4969
|
215
|
4970 See also @code{Syntax Highlighting} from the @code{Options} menu.
|
|
4971 Remember to save options.
|
|
4972
|
82
|
4973 @node Q5.0.2, Q5.0.3, Q5.0.1, Miscellaneous
|
274
|
4974 @unnumberedsubsec Q5.0.2: I do not like cc-mode. How do I use the old c-mode?
|
82
|
4975
|
|
4976 Well, first off, consider if you really want to do this. cc-mode is
|
|
4977 much more powerful than the old c-mode. If you're having trouble
|
|
4978 getting your old offsets to work, try using @code{c-set-offset} instead.
|
|
4979 You might also consider using the package @code{cc-compat}.
|
|
4980
|
|
4981 But, if you still insist, add the following lines to your @file{.emacs}:
|
|
4982
|
|
4983 @lisp
|
|
4984 (fmakunbound 'c-mode)
|
|
4985 (makunbound 'c-mode-map)
|
|
4986 (fmakunbound 'c++-mode)
|
|
4987 (makunbound 'c++-mode-map)
|
|
4988 (makunbound 'c-style-alist)
|
|
4989 (load-library "old-c-mode")
|
282
|
4990 (load-library "old-c++-mode")
|
82
|
4991 @end lisp
|
|
4992
|
|
4993 This must be done before any other reference is made to either c-mode or
|
|
4994 c++-mode.
|
|
4995
|
|
4996 @node Q5.0.3, Q5.0.4, Q5.0.2, Miscellaneous
|
274
|
4997 @unnumberedsubsec Q5.0.3: How do I get @samp{More} Syntax Highlighting on by default?
|
82
|
4998
|
163
|
4999 Use the following code in your @file{.emacs}:
|
82
|
5000
|
|
5001 @lisp
|
163
|
5002 (setq-default font-lock-maximum-decoration t)
|
82
|
5003 @end lisp
|
|
5004
|
163
|
5005 In versions of XEmacs prior to 19.14, you had to use a kludgy solution
|
|
5006 like this:
|
|
5007
|
|
5008 @lisp
|
|
5009 (setq c-font-lock-keywords c-font-lock-keywords-2
|
|
5010 c++-font-lock-keywords c++-font-lock-keywords-2
|
|
5011 lisp-font-lock-keywords lisp-font-lock-keywords-2)
|
|
5012 @end lisp
|
|
5013
|
|
5014 It will work for C, C++ and Lisp.
|
|
5015
|
215
|
5016 See also @code{Syntax Highlighting} from the @code{Options} menu.
|
|
5017 Remember to save options.
|
|
5018
|
82
|
5019 @node Q5.0.4, Q5.0.5, Q5.0.3, Miscellaneous
|
274
|
5020 @unnumberedsubsec Q5.0.4: How can I enable auto-indent?
|
82
|
5021
|
|
5022 Put the following line in your @file{.emacs}:
|
|
5023
|
|
5024 @lisp
|
|
5025 (setq indent-line-function 'indent-relative-maybe)
|
|
5026 @end lisp
|
|
5027
|
|
5028 If you want to get fancy, try the @code{filladapt} package available
|
|
5029 standard with XEmacs. Put this into your @file{.emacs}:
|
|
5030
|
|
5031 @lisp
|
|
5032 (require 'filladapt)
|
|
5033 (add-hook 'text-mode-hook 'turn-on-filladapt-mode)
|
163
|
5034 ;;; and others ...
|
82
|
5035 @end lisp
|
|
5036
|
215
|
5037 You can customize filling and adaptive filling with Customize.
|
|
5038 Select from the @code{Options} menu
|
|
5039 @code{Customize->Emacs->->Editing->Fill->Fill...}
|
282
|
5040 or type @kbd{M-x customize @key{RET} fill @key{RET}}.
|
215
|
5041
|
163
|
5042 Note that well-behaving text-lookalike modes will run
|
|
5043 @code{text-mode-hook} by default (e.g. that's what Message does). For
|
|
5044 the nasty ones, you'll have to provide the @code{add-hook}s yourself.
|
|
5045
|
82
|
5046 Please note that the @code{fa-extras} package is no longer useful.
|
|
5047
|
|
5048 @node Q5.0.5, Q5.0.6, Q5.0.4, Miscellaneous
|
274
|
5049 @unnumberedsubsec Q5.0.5: How can I get XEmacs to come up in text/auto-fill mode by default?
|
82
|
5050
|
|
5051 Try the following lisp in your @file{.emacs}:
|
|
5052
|
|
5053 @lisp
|
|
5054 (setq default-major-mode 'text-mode)
|
|
5055 (setq text-mode-hook 'turn-on-auto-fill)
|
|
5056 @end lisp
|
|
5057
|
|
5058 @strong{WARNING}: note that changing the value of
|
|
5059 @code{default-major-mode} from @code{fundamental-mode} can break a large
|
|
5060 amount of built-in code that expects newly created buffers to be in
|
|
5061 @code{fundamental-mode}. (Changing from @code{fundamental-mode} to
|
|
5062 @code{text-mode} might not wreak too much havoc, but changing to
|
|
5063 something more exotic like a lisp-mode would break many Emacs packages).
|
|
5064
|
|
5065 Note that Emacs by default starts up in buffer @code{*scratch*} in
|
|
5066 @code{initial-major-mode}, which defaults to
|
|
5067 @code{lisp-interaction-mode}. Thus adding the following form to your
|
|
5068 Emacs init file will cause the initial @code{*scratch*} buffer to be put
|
|
5069 into auto-fill'ed @code{text-mode}:
|
|
5070
|
|
5071 @lisp
|
|
5072 (setq initial-major-mode
|
163
|
5073 (lambda ()
|
82
|
5074 (text-mode)
|
163
|
5075 (turn-on-auto-fill)))
|
82
|
5076 @end lisp
|
|
5077
|
|
5078 Note that after your init file is loaded, if
|
163
|
5079 @code{inhibit-startup-message} is @code{nil} (the default) and the
|
|
5080 startup buffer is @code{*scratch*} then the startup message will be
|
|
5081 inserted into @code{*scratch*}; it will be removed after a timeout by
|
|
5082 erasing the entire @code{*scratch*} buffer. Keep in mind this default
|
|
5083 usage of @code{*scratch*} if you desire any prior manipulation of
|
82
|
5084 @code{*scratch*} from within your Emacs init file. In particular,
|
|
5085 anything you insert into @code{*scratch*} from your init file will be
|
|
5086 later erased. Also, if you change the mode of the @code{*scratch*}
|
|
5087 buffer, be sure that this will not interfere with possible later
|
|
5088 insertion of the startup message (e.g. if you put @code{*scratch*} into
|
|
5089 a nonstandard mode that has automatic font lock rules, then the startup
|
|
5090 message might get fontified in a strange foreign manner, e.g. as code in
|
|
5091 some programming language).
|
|
5092
|
|
5093 @node Q5.0.6, Q5.0.7, Q5.0.5, Miscellaneous
|
274
|
5094 @unnumberedsubsec Q5.0.6: How do I start up a second shell buffer?
|
82
|
5095
|
|
5096 In the @code{*shell*} buffer:
|
|
5097
|
|
5098 @lisp
|
282
|
5099 M-x rename-buffer @key{RET} *shell-1* @key{RET}
|
82
|
5100 M-x shell RET
|
|
5101 @end lisp
|
|
5102
|
|
5103 This will then start a second shell. The key is that no buffer named
|
|
5104 @samp{*shell*} can exist. It might be preferable to use @kbd{M-x
|
|
5105 rename-uniquely} to rename the @code{*shell*} buffer instead of @kbd{M-x
|
|
5106 rename-buffer}.
|
|
5107
|
|
5108 @node Q5.0.7, Q5.0.8, Q5.0.6, Miscellaneous
|
274
|
5109 @unnumberedsubsec Q5.0.7: Telnet from shell filters too much
|
82
|
5110
|
|
5111 I'm using the Emacs @kbd{M-x shell} function, and I would like to invoke
|
|
5112 and use a telnet session within it. Everything works fine except that
|
|
5113 now all @samp{^M}'s are filtered out by Emacs. Fixes?
|
|
5114
|
|
5115 Use @kbd{M-x rsh} or @kbd{M-x telnet} to open remote sessions rather
|
227
|
5116 than doing rsh or telnet within the local shell buffer. Starting with
|
|
5117 XEmacs-20.3 you can also use @kbd{M-x ssh} to open secure remote session
|
|
5118 if you have @code{ssh} installed.
|
82
|
5119
|
|
5120 @node Q5.0.8, Q5.0.9, Q5.0.7, Miscellaneous
|
274
|
5121 @unnumberedsubsec Q5.0.8: Why does edt emulation not work?
|
82
|
5122
|
|
5123 We don't know, but you can use tpu-edt emulation instead, which works
|
|
5124 fine and is a little fancier than the standard edt emulation. To do
|
|
5125 this, add the following line to your @file{.emacs}:
|
|
5126
|
|
5127 @lisp
|
163
|
5128 (tpu-edt)
|
82
|
5129 @end lisp
|
|
5130
|
|
5131 If you don't want it to replace @kbd{C-h} with an edt-style help menu
|
|
5132 add this as well:
|
|
5133
|
|
5134 @lisp
|
163
|
5135 (global-set-key [(control h)] 'help-for-help)
|
82
|
5136 @end lisp
|
|
5137
|
|
5138 @node Q5.0.9, Q5.0.10, Q5.0.8, Miscellaneous
|
274
|
5139 @unnumberedsubsec Q5.0.9: How can I emulate VI and use it as my default mode?
|
82
|
5140
|
|
5141 Our recommended VI emulator is viper. To make viper-mode the default,
|
|
5142 add this to your @file{.emacs}:
|
|
5143
|
|
5144 @lisp
|
|
5145 (viper-mode)
|
|
5146 @end lisp
|
|
5147
|
274
|
5148 @email{kifer@@CS.SunySB.EDU, Michael Kifer} writes:
|
82
|
5149
|
|
5150 @quotation
|
|
5151 This should be added as close to the top of @file{.emacs} as you can get
|
|
5152 it, otherwise some minor modes may not get viper-ized.
|
|
5153 @end quotation
|
|
5154
|
|
5155 @node Q5.0.10, Q5.0.11, Q5.0.9, Miscellaneous
|
274
|
5156 @unnumberedsubsec Q5.0.10: [This question intentionally left blank]
|
126
|
5157
|
|
5158 Obsolete question, left blank to avoid renumbering
|
282
|
5159
|
82
|
5160 @node Q5.0.11, Q5.0.12, Q5.0.10, Miscellaneous
|
274
|
5161 @unnumberedsubsec Q5.0.11: Filladapt doesn't work in 19.15
|
126
|
5162
|
|
5163 Filladapt 2.x is included in 19.15. In it filladapt is now a minor
|
82
|
5164 mode and minor modes are traditionally off by default. The following
|
|
5165 added to your @file{.emacs} will turn it on for all buffers:
|
|
5166
|
|
5167 @lisp
|
|
5168 (setq-default filladapt-mode t)
|
|
5169 @end lisp
|
|
5170
|
|
5171 Use @code{turn-on-filladapt-mode} to turn Filladapt on in particular
|
|
5172 major modes, like this:
|
|
5173
|
|
5174 @lisp
|
282
|
5175 (add-hook 'text-mode-hook 'turn-on-filladapt-mode)
|
82
|
5176 @end lisp
|
|
5177
|
|
5178 @node Q5.0.12, Q5.0.13, Q5.0.11, Miscellaneous
|
274
|
5179 @unnumberedsubsec Q5.0.12: How do I disable gnuserv from opening a new frame?
|
82
|
5180
|
|
5181 If you set the @code{gnuserv-frame} variable to the frame that should be
|
|
5182 used to display buffers that are pulled up, a new frame will not be
|
|
5183 created. For example, you could put
|
|
5184
|
|
5185 @lisp
|
|
5186 (setq gnuserv-frame (selected-frame))
|
|
5187 @end lisp
|
|
5188
|
|
5189 early on in your @file{.emacs}, to ensure that the first frame created
|
|
5190 is the one used for your gnuserv buffers.
|
|
5191
|
|
5192 Starting in 19.15, there is an option to set the gnuserv target to
|
|
5193 the current frame. See
|
|
5194 @code{Options->"Other Window" Location->Make current frame gnuserv target}
|
|
5195
|
227
|
5196 Starting with XEmacs-20.3 you can also change this with Customize.
|
|
5197 Select from the @code{Options} menu
|
|
5198 @code{Customize->Emacs->Environment->Gnuserv->Gnuserv Frame...} or type
|
282
|
5199 @kbd{M-x customize @key{RET} gnuserv @key{RET}}.
|
227
|
5200
|
|
5201
|
82
|
5202 @node Q5.0.13, Q5.0.14, Q5.0.12, Miscellaneous
|
274
|
5203 @unnumberedsubsec Q5.0.13: How do I start gnuserv so that each subsequent XEmacs is a client?
|
82
|
5204
|
|
5205 Put the following in your @file{.emacs} file to start the server:
|
|
5206
|
|
5207 @lisp
|
|
5208 (gnuserv-start)
|
|
5209 @end lisp
|
|
5210
|
|
5211 Start your first XEmacs as usual. After that, you can do:
|
70
|
5212
|
|
5213 @example
|
82
|
5214 gnuclient randomfilename
|
70
|
5215 @end example
|
|
5216
|
82
|
5217 from the command line to get your existing XEmacs process to open a new
|
|
5218 frame and visit randomfilename in that window. When you're done editing
|
|
5219 randomfilename, hit @kbd{C-x #} to kill the buffer and get rid of the
|
|
5220 frame.
|
|
5221
|
227
|
5222 See also man page of gnuclient.
|
|
5223
|
82
|
5224 @node Q5.0.14, Q5.0.15, Q5.0.13, Miscellaneous
|
274
|
5225 @unnumberedsubsec Q5.0.14: Strange things are happening in Shell Mode.
|
82
|
5226
|
|
5227 Sometimes (i.e. it's not repeatable, and I can't work out why it
|
|
5228 happens) when I'm typing into shell mode, I hit return and only a
|
|
5229 portion of the command is given to the shell, and a blank prompt is
|
|
5230 returned. If I hit return again, the rest of the previous command is
|
|
5231 given to the shell.
|
|
5232
|
274
|
5233 @email{martin@@xemacs.org, Martin Buchholz} writes:
|
82
|
5234
|
|
5235 @quotation
|
|
5236 There is a known problem with interaction between @code{csh} and the
|
|
5237 @code{filec} option and XEmacs. You should add the following to your
|
|
5238 @file{.cshrc}:
|
70
|
5239
|
|
5240 @example
|
82
|
5241 if ( "$TERM" == emacs || "$TERM" == unknown ) unset filec
|
70
|
5242 @end example
|
82
|
5243 @end quotation
|
|
5244
|
|
5245 @node Q5.0.15, Q5.0.16, Q5.0.14, Miscellaneous
|
274
|
5246 @unnumberedsubsec Q5.0.15: Where do I get the latest CC Mode?
|
|
5247
|
|
5248 @email{bwarsaw@@cnri.reston.va.us, Barry A. Warsaw} writes:
|
82
|
5249
|
|
5250 @quotation
|
274
|
5251 This can be had from @uref{http://www.python.org/ftp/emacs/}.
|
82
|
5252 @end quotation
|
|
5253
|
|
5254 @node Q5.0.16, Q5.0.17, Q5.0.15, Miscellaneous
|
274
|
5255 @unnumberedsubsec Q5.0.16: I find auto-show-mode disconcerting. How do I turn it off?
|
82
|
5256
|
|
5257 @code{auto-show-mode} controls whether or not a horizontal scrollbar
|
|
5258 magically appears when a line is too long to be displayed. This is
|
|
5259 enabled by default. To turn it off, put the following in your
|
|
5260 @file{.emacs}:
|
|
5261
|
|
5262 @lisp
|
|
5263 (setq auto-show-mode nil)
|
|
5264 (setq-default auto-show-mode nil)
|
|
5265 @end lisp
|
|
5266
|
|
5267 @node Q5.0.17, Q5.0.18, Q5.0.16, Miscellaneous
|
274
|
5268 @unnumberedsubsec Q5.0.17: How can I get two instances of info?
|
82
|
5269
|
227
|
5270 You can't. The @code{info} package does not provide for multiple info buffers.
|
82
|
5271
|
|
5272 @node Q5.0.18, Q5.0.19, Q5.0.17, Miscellaneous
|
274
|
5273 @unnumberedsubsec Q5.0.18: I upgraded to XEmacs 19.14 and gnuserv stopped working.
|
|
5274
|
|
5275 @email{daku@@nortel.ca, Mark Daku} writes:
|
82
|
5276
|
|
5277 @quotation
|
|
5278 It turns out I was using an older version of gnuserv. The installation
|
|
5279 didn't put the binary into the public bin directory. It put it in
|
274
|
5280 @iftex
|
|
5281 @*
|
282
|
5282 @end iftex
|
82
|
5283 @file{lib/xemacs-19.14/hppa1.1-hp-hpux9.05/gnuserv}. Shouldn't it have
|
|
5284 been put in @file{bin/hppa1.1-hp-hpux9.0}?
|
|
5285 @end quotation
|
|
5286
|
274
|
5287 @node Q5.0.19, Q5.0.20, Q5.0.18, Miscellaneous
|
|
5288 @unnumberedsubsec Q5.0.19: Is there something better than LaTeX mode?
|
|
5289
|
|
5290 @email{dak@@fsnif.neuroinformatik.ruhr-uni-bochum.de, David Kastrup} writes:
|
82
|
5291
|
|
5292 @quotation
|
|
5293 The standard TeX modes leave much to be desired, and are somewhat
|
163
|
5294 leniently maintained. Serious TeX users use AUC TeX (@xref{Q4.7.1}).
|
82
|
5295 @end quotation
|
|
5296
|
274
|
5297 @node Q5.0.20, Q5.1.1, Q5.0.19, Miscellaneous
|
|
5298 @unnumberedsubsec Q5.0.20: Is there a way to start a new XEmacs if there's no gnuserv running, and otherwise use gnuclient?
|
|
5299
|
|
5300 @email{vroonhof@@math.ethz.ch, Jan Vroonhof} writes:
|
|
5301 @quotation
|
|
5302 Here is one of the solutions, we have this in a script called
|
|
5303 @file{etc/editclient.sh}.
|
|
5304 @example
|
|
5305 #!/bin/sh
|
|
5306 if gnuclient -batch -eval t >/dev/null 2>&1
|
|
5307 then
|
|
5308 exec gnuclient $@{1+"$@@"@}
|
|
5309 else
|
|
5310 xemacs -unmapped -f gnuserv-start &
|
|
5311 until gnuclient -batch -eval t >/dev/null 2>&1
|
|
5312 do
|
|
5313 sleep 1
|
|
5314 done
|
|
5315 exec gnuclient $@{1+"$@@"@}
|
|
5316 fi
|
|
5317 @end example
|
|
5318
|
|
5319 Note that there is a known problem when running XEmacs and 'gnuclient
|
|
5320 -nw' on the same TTY.
|
|
5321 @end quotation
|
|
5322
|
|
5323 @node Q5.1.1, Q5.1.2, Q5.0.20, Miscellaneous
|
282
|
5324 @unnumberedsec 5.1: Emacs Lisp Programming Techniques
|
274
|
5325 @unnumberedsubsec Q5.1.1: What is the difference in key sequences between XEmacs and GNU Emacs?
|
|
5326
|
|
5327 @email{clerik@@naggum.no, Erik Naggum} writes;
|
82
|
5328
|
|
5329 @quotation
|
|
5330 Emacs has a legacy of keyboards that produced characters with modifier
|
|
5331 bits, and therefore map a variety of input systems into this scheme even
|
|
5332 today. XEmacs is instead optimized for X events. This causes an
|
|
5333 incompatibility in the way key sequences are specified, but both Emacs
|
|
5334 and XEmacs will accept a key sequence as a vector of lists of modifiers
|
163
|
5335 that ends with a key, e.g., to bind @kbd{M-C-a}, you would say
|
|
5336 @code{[(meta control a)]} in both Emacsen. XEmacs has an abbreviated
|
|
5337 form for a single key, just (meta control a). Emacs has an abbreviated
|
|
5338 form for the Control and the Meta modifiers to string-characters (the
|
|
5339 ASCII characters), as in @samp{\M-\C-a}. XEmacs users need to be aware
|
|
5340 that the abbreviated form works only for one-character key sequences,
|
|
5341 while Emacs users need to be aware that the string-character is rather
|
217
|
5342 limited. Specifically, the string-character can accommodate only 256
|
163
|
5343 different values, 128 of which have the Meta modifier and 128 of which
|
|
5344 have not. In each of these blocks, only 32 characters have the Control
|
|
5345 modifier. Whereas @code{[(meta control A)]} differs from @code{[(meta
|
|
5346 control a)]} because the case differs, @samp{\M-\C-a} and @samp{\M-\C-A}
|
|
5347 do not. Programmers are advised to use the full common form, both
|
|
5348 because it is more readable and less error-prone, and because it is
|
|
5349 supported by both Emacsen.
|
82
|
5350 @end quotation
|
|
5351
|
163
|
5352 Another (even safer) way to be sure of the key-sequences is to use the
|
|
5353 @code{read-kbd-macro} function, which takes a string like @samp{C-c
|
|
5354 <up>}, and converts it to the internal key representation of the Emacs
|
|
5355 you use. The function is available both on XEmacs and GNU Emacs.
|
|
5356
|
82
|
5357 @node Q5.1.2, Q5.1.3, Q5.1.1, Miscellaneous
|
274
|
5358 @unnumberedsubsec Q5.1.2: Can I generate "fake" keyboard events?
|
82
|
5359
|
163
|
5360 I wonder if there is an interactive function that can generate
|
|
5361 @dfn{fake} keyboard events. This way, I could simply map them inside
|
|
5362 XEmacs.
|
70
|
5363
|
|
5364 This seems to work:
|
82
|
5365
|
|
5366 @lisp
|
70
|
5367 (defun cg--generate-char-event (ch)
|
|
5368 "Generate an event, as if ch has been typed"
|
|
5369 (dispatch-event (character-to-event ch)))
|
|
5370
|
|
5371 ;; Backspace and Delete stuff
|
163
|
5372 (global-set-key [backspace]
|
274
|
5373 (lambda () (interactive) (cg--generate-char-event 127)))
|
163
|
5374 (global-set-key [unknown_keysym_0x4]
|
274
|
5375 (lambda () (interactive) (cg--generate-char-event 4)))
|
82
|
5376 @end lisp
|
|
5377
|
|
5378 @node Q5.1.3, Q5.1.4, Q5.1.2, Miscellaneous
|
274
|
5379 @unnumberedsubsec Q5.1.3: Could you explain @code{read-kbd-macro} in more detail?
|
163
|
5380
|
|
5381 The @code{read-kbd-macro} function returns the internal Emacs
|
|
5382 representation of a human-readable string (which is its argument).
|
|
5383 Thus:
|
82
|
5384
|
|
5385 @lisp
|
163
|
5386 (read-kbd-macro "C-c C-a")
|
274
|
5387 @result{} [(control ?c) (control ?a)]
|
163
|
5388
|
|
5389 (read-kbd-macro "C-c C-. <up>")
|
274
|
5390 @result{} [(control ?c) (control ?.) up]
|
82
|
5391 @end lisp
|
|
5392
|
163
|
5393 In GNU Emacs the same forms will be evaluated to what GNU Emacs
|
|
5394 understands internally---the sequences @code{"\C-x\C-c"} and @code{[3
|
|
5395 67108910 up]}, respectively.
|
|
5396
|
|
5397 The exact @dfn{human-readable} syntax is defined in the docstring of
|
|
5398 @code{edmacro-mode}. I'll repeat it here, for completeness.
|
|
5399
|
|
5400 @quotation
|
|
5401 Format of keyboard macros during editing:
|
|
5402
|
|
5403 Text is divided into @dfn{words} separated by whitespace. Except for
|
|
5404 the words described below, the characters of each word go directly as
|
|
5405 characters of the macro. The whitespace that separates words is
|
|
5406 ignored. Whitespace in the macro must be written explicitly, as in
|
282
|
5407 @kbd{foo @key{SPC} bar @key{RET}}.
|
163
|
5408
|
|
5409 @itemize @bullet
|
|
5410 @item
|
|
5411 The special words @kbd{RET}, @kbd{SPC}, @kbd{TAB}, @kbd{DEL}, @kbd{LFD},
|
|
5412 @kbd{ESC}, and @kbd{NUL} represent special control characters. The
|
|
5413 words must be written in uppercase.
|
|
5414
|
|
5415 @item
|
|
5416 A word in angle brackets, e.g., @code{<return>}, @code{<down>}, or
|
|
5417 @code{<f1>}, represents a function key. (Note that in the standard
|
|
5418 configuration, the function key @code{<return>} and the control key
|
282
|
5419 @key{RET} are synonymous.) You can use angle brackets on the words
|
|
5420 @key{RET}, @key{SPC}, etc., but they are not required there.
|
163
|
5421
|
|
5422 @item
|
|
5423 Keys can be written by their @sc{ascii} code, using a backslash followed
|
|
5424 by up to six octal digits. This is the only way to represent keys with
|
|
5425 codes above \377.
|
|
5426
|
|
5427 @item
|
|
5428 One or more prefixes @kbd{M-} (meta), @kbd{C-} (control), @kbd{S-}
|
|
5429 (shift), @kbd{A-} (alt), @kbd{H-} (hyper), and @kbd{s-} (super) may
|
|
5430 precede a character or key notation. For function keys, the prefixes
|
|
5431 may go inside or outside of the brackets: @code{C-<down>} @equiv{}
|
|
5432 @code{<C-down>}. The prefixes may be written in any order: @kbd{M-C-x}
|
|
5433 @equiv{} @kbd{C-M-x}.
|
|
5434
|
|
5435 Prefixes are not allowed on multi-key words, e.g., @kbd{C-abc}, except
|
|
5436 that the Meta prefix is allowed on a sequence of digits and optional
|
|
5437 minus sign: @kbd{M--123} @equiv{} @kbd{M-- M-1 M-2 M-3}.
|
|
5438
|
|
5439 @item
|
|
5440 The @code{^} notation for control characters also works: @kbd{^M}
|
|
5441 @equiv{} @kbd{C-m}.
|
|
5442
|
|
5443 @item
|
|
5444 Double angle brackets enclose command names: @code{<<next-line>>} is
|
282
|
5445 shorthand for @kbd{M-x next-line @key{RET}}.
|
163
|
5446
|
|
5447 @item
|
|
5448 Finally, @code{REM} or @code{;;} causes the rest of the line to be
|
|
5449 ignored as a comment.
|
|
5450 @end itemize
|
|
5451
|
|
5452 Any word may be prefixed by a multiplier in the form of a decimal number
|
|
5453 and @code{*}: @code{3*<right>} @equiv{} @code{<right> <right> <right>},
|
282
|
5454 and @code{10*foo} @equiv{}
|
274
|
5455 @iftex
|
|
5456 @*
|
282
|
5457 @end iftex
|
274
|
5458 @code{foofoofoofoofoofoofoofoofoofoo}.
|
163
|
5459
|
|
5460 Multiple text keys can normally be strung together to form a word, but
|
|
5461 you may need to add whitespace if the word would look like one of the
|
|
5462 above notations: @code{; ; ;} is a keyboard macro with three semicolons,
|
|
5463 but @code{;;;} is a comment. Likewise, @code{\ 1 2 3} is four keys but
|
|
5464 @code{\123} is a single key written in octal, and @code{< right >} is
|
|
5465 seven keys but @code{<right>} is a single function key. When in doubt,
|
|
5466 use whitespace.
|
|
5467 @end quotation
|
|
5468
|
|
5469 @node Q5.1.4, Q5.1.5, Q5.1.3, Miscellaneous
|
274
|
5470 @unnumberedsubsec Q5.1.4: What is the performance hit of @code{let}?
|
163
|
5471
|
217
|
5472 In most cases, not noticeable. Besides, there's no avoiding
|
163
|
5473 @code{let}---you have to bind your local variables, after all. Some
|
|
5474 pose a question whether to nest @code{let}s, or use one @code{let} per
|
|
5475 function. I think because of clarity and maintenance (and possible
|
|
5476 future implementation), @code{let}-s should be used (nested) in a way to
|
|
5477 provide the clearest code.
|
|
5478
|
|
5479 @node Q5.1.5, Q5.1.6, Q5.1.4, Miscellaneous
|
274
|
5480 @unnumberedsubsec Q5.1.5: What is the recommended use of @code{setq}?
|
163
|
5481
|
|
5482 @itemize @bullet
|
|
5483 @item Global variables
|
|
5484
|
|
5485 You will typically @code{defvar} your global variable to a default
|
|
5486 value, and use @code{setq} to set it later.
|
|
5487
|
|
5488 It is never a good practice to @code{setq} user variables (like
|
|
5489 @code{case-fold-search}, etc.), as it ignores the user's choice
|
|
5490 unconditionally. Note that @code{defvar} doesn't change the value of a
|
|
5491 variable if it was bound previously. If you wish to change a
|
|
5492 user-variable temporarily, use @code{let}:
|
82
|
5493
|
|
5494 @lisp
|
163
|
5495 (let ((case-fold-search nil))
|
274
|
5496 ... ; code with searches that must be case-sensitive
|
163
|
5497 ...)
|
82
|
5498 @end lisp
|
|
5499
|
163
|
5500 You will notice the user-variables by their docstrings beginning with an
|
|
5501 asterisk (a convention).
|
|
5502
|
|
5503 @item Local variables
|
|
5504
|
|
5505 Bind them with @code{let}, which will unbind them (or restore their
|
|
5506 previous value, if they were bound) after exiting from the @code{let}
|
|
5507 form. Change the value of local variables with @code{setq} or whatever
|
|
5508 you like (e.g. @code{incf}, @code{setf} and such). The @code{let} form
|
|
5509 can even return one of its local variables.
|
|
5510
|
|
5511 Typical usage:
|
82
|
5512
|
|
5513 @lisp
|
163
|
5514 ;; iterate through the elements of the list returned by
|
|
5515 ;; `hairy-function-that-returns-list'
|
|
5516 (let ((l (hairy-function-that-returns-list)))
|
|
5517 (while l
|
|
5518 ... do something with (car l) ...
|
|
5519 (setq l (cdr l))))
|
|
5520 @end lisp
|
|
5521
|
|
5522 Another typical usage includes building a value simply to work with it.
|
|
5523
|
|
5524 @lisp
|
|
5525 ;; Build the mode keymap out of the key-translation-alist
|
|
5526 (let ((inbox (file-truename (expand-file-name box)))
|
|
5527 (i 0))
|
|
5528 ... code dealing with inbox ...
|
|
5529 inbox)
|
|
5530 @end lisp
|
|
5531
|
|
5532 This piece of code uses the local variable @code{inbox}, which becomes
|
|
5533 unbound (or regains old value) after exiting the form. The form also
|
|
5534 returns the value of @code{inbox}, which can be reused, for instance:
|
|
5535
|
|
5536 @lisp
|
|
5537 (setq foo-processed-inbox
|
|
5538 (let .....))
|
82
|
5539 @end lisp
|
163
|
5540 @end itemize
|
|
5541
|
|
5542 @node Q5.1.6, Q5.1.7, Q5.1.5, Miscellaneous
|
274
|
5543 @unnumberedsubsec Q5.1.6: What is the typical misuse of @code{setq} ?
|
163
|
5544
|
|
5545 A typical misuse is probably @code{setq}ing a variable that was meant to
|
|
5546 be local. Such a variable will remain bound forever, never to be
|
|
5547 garbage-collected. For example, the code doing:
|
|
5548
|
|
5549 @lisp
|
|
5550 (defun my-function (whatever)
|
|
5551 (setq a nil)
|
|
5552 ... build a large list ...
|
|
5553 ... and exit ...)
|
|
5554 @end lisp
|
|
5555
|
|
5556 does a bad thing, as @code{a} will keep consuming memory, never to be
|
|
5557 unbound. The correct thing is to do it like this:
|
|
5558
|
|
5559 @lisp
|
|
5560 (defun my-function (whatever)
|
274
|
5561 (let (a) ; default initialization is to nil
|
163
|
5562 ... build a large list ...
|
|
5563 ... and exit, unbinding `a' in the process ...)
|
|
5564 @end lisp
|
|
5565
|
|
5566 Not only is this prettier syntactically, but it makes it possible for
|
|
5567 Emacs to garbage-collect the objects which @code{a} used to reference.
|
|
5568
|
|
5569 Note that even global variables should not be @code{setq}ed without
|
|
5570 @code{defvar}ing them first, because the byte-compiler issues warnings.
|
|
5571 The reason for the warning is the following:
|
|
5572
|
|
5573 @lisp
|
274
|
5574 (defun flurgoze nil) ; ok, global internal variable
|
163
|
5575 ...
|
|
5576
|
274
|
5577 (setq flurghoze t) ; ops! a typo, but semantically correct.
|
|
5578 ; however, the byte-compiler warns.
|
163
|
5579
|
|
5580 While compiling toplevel forms:
|
274
|
5581 ** assignment to free variable flurghoze
|
163
|
5582 @end lisp
|
|
5583
|
|
5584 @node Q5.1.7, Q5.1.8, Q5.1.6, Miscellaneous
|
274
|
5585 @unnumberedsubsec Q5.1.7: I like the the @code{do} form of cl, does it slow things down?
|
163
|
5586
|
|
5587 It shouldn't. Here is what Dave Gillespie has to say about cl.el
|
|
5588 performance:
|
82
|
5589
|
|
5590 @quotation
|
163
|
5591 Many of the advanced features of this package, such as @code{defun*},
|
|
5592 @code{loop}, and @code{setf}, are implemented as Lisp macros. In
|
|
5593 byte-compiled code, these complex notations will be expanded into
|
|
5594 equivalent Lisp code which is simple and efficient. For example, the
|
|
5595 forms
|
82
|
5596
|
|
5597 @lisp
|
163
|
5598 (incf i n)
|
|
5599 (push x (car p))
|
82
|
5600 @end lisp
|
|
5601
|
163
|
5602 are expanded at compile-time to the Lisp forms
|
82
|
5603
|
|
5604 @lisp
|
163
|
5605 (setq i (+ i n))
|
|
5606 (setcar p (cons x (car p)))
|
82
|
5607 @end lisp
|
|
5608
|
163
|
5609 which are the most efficient ways of doing these respective operations
|
|
5610 in Lisp. Thus, there is no performance penalty for using the more
|
|
5611 readable @code{incf} and @code{push} forms in your compiled code.
|
|
5612
|
|
5613 @emph{Interpreted} code, on the other hand, must expand these macros
|
|
5614 every time they are executed. For this reason it is strongly
|
|
5615 recommended that code making heavy use of macros be compiled. (The
|
|
5616 features labelled @dfn{Special Form} instead of @dfn{Function} in this
|
|
5617 manual are macros.) A loop using @code{incf} a hundred times will
|
|
5618 execute considerably faster if compiled, and will also garbage-collect
|
|
5619 less because the macro expansion will not have to be generated, used,
|
|
5620 and thrown away a hundred times.
|
|
5621
|
|
5622 You can find out how a macro expands by using the @code{cl-prettyexpand}
|
|
5623 function.
|
82
|
5624 @end quotation
|
|
5625
|
163
|
5626 @node Q5.1.8, Q5.1.9, Q5.1.7, Miscellaneous
|
274
|
5627 @unnumberedsubsec Q5.1.8: I like recursion, does it slow things down?
|
163
|
5628
|
|
5629 Yes. Emacs byte-compiler cannot do much to optimize recursion. But
|
|
5630 think well whether this is a real concern in Emacs. Much of the Emacs
|
|
5631 slowness comes from internal mechanisms such as redisplay, or from the
|
|
5632 fact that it is an interpreter.
|
|
5633
|
|
5634 Please try not to make your code much uglier to gain a very small speed
|
|
5635 gain. It's not usually worth it.
|
|
5636
|
213
|
5637 @node Q5.1.9, Q5.1.10, Q5.1.8, Miscellaneous
|
274
|
5638 @unnumberedsubsec Q5.1.9: How do I put a glyph as annotation in a buffer?
|
163
|
5639
|
|
5640 Here is a solution that will insert the glyph annotation at the
|
|
5641 beginning of buffer:
|
|
5642
|
|
5643 @lisp
|
|
5644 (make-annotation (make-glyph '([FORMAT :file FILE]
|
|
5645 [string :data "fallback-text"]))
|
|
5646 (point-min)
|
|
5647 'text
|
|
5648 (current-buffer))
|
|
5649 @end lisp
|
|
5650
|
282
|
5651 Replace @samp{FORMAT} with an unquoted symbol representing the format of
|
163
|
5652 the image (e.g. @code{xpm}, @code{xbm}, @code{gif}, @code{jpeg}, etc.)
|
|
5653 Instead of @samp{FILE}, use the image file name
|
282
|
5654 (e.g.
|
274
|
5655 @iftex
|
|
5656 @*
|
282
|
5657 @end iftex
|
274
|
5658 @file{/usr/local/lib/xemacs-20.2/etc/recycle.xpm}).
|
163
|
5659
|
|
5660 You can turn this to a function (that optionally prompts you for a file
|
|
5661 name), and inserts the glyph at @code{(point)} instead of
|
|
5662 @code{(point-min)}.
|
|
5663
|
282
|
5664 @node Q5.1.10, Q5.1.11, Q5.1.9, Miscellaneous
|
274
|
5665 @unnumberedsubsec Q5.1.10: @code{map-extents} won't traverse all of my extents!
|
213
|
5666
|
|
5667 I tried to use @code{map-extents} to do an operation on all the extents
|
282
|
5668 in a region. However, it seems to quit after processing a random number
|
213
|
5669 of extents. Is it buggy?
|
|
5670
|
282
|
5671 No. The documentation of @code{map-extents} states that it will iterate
|
213
|
5672 across the extents as long as @var{function} returns @code{nil}.
|
|
5673 Unexperienced programmers often forget to return @code{nil} explicitly,
|
|
5674 which results in buggy code. For instance, the following code is
|
|
5675 supposed to delete all the extents in a buffer, and issue as many
|
|
5676 @samp{fubar!} messages.
|
|
5677
|
|
5678 @lisp
|
|
5679 (map-extents (lambda (ext ignore)
|
|
5680 (delete-extent ext)
|
|
5681 (message "fubar!")))
|
|
5682 @end lisp
|
|
5683
|
|
5684 Instead, it will delete only the first extent, and stop right there --
|
|
5685 because @code{message} will return a non-nil value. The correct code
|
|
5686 is:
|
|
5687
|
|
5688 @lisp
|
|
5689 (map-extents (lambda (ext ignore)
|
|
5690 (delete-extent ext)
|
|
5691 (message "fubar!")
|
|
5692 nil))
|
|
5693 @end lisp
|
|
5694
|
282
|
5695 @node Q5.1.11, Q5.2.1, Q5.1.10, Miscellaneous
|
|
5696 @unnumberedsubsec Q5.1.11: My elisp program is horribly slow. Is there
|
|
5697 an easy way to find out where it spends time?
|
|
5698 @c New
|
|
5699
|
|
5700 z@email{hniksic@@srce.hr, Hrvoje Niksic} writes:
|
|
5701 @quotation
|
|
5702 Under XEmacs 20.4 and later you can use @kbd{M-x profile-key-sequence}, press a key
|
|
5703 (say @key{RET} in the Gnus Group buffer), and get the results using
|
|
5704 @kbd{M-x profile-results}. It should give you an idea of where the time
|
|
5705 is being spent.
|
|
5706 @end quotation
|
|
5707
|
|
5708 @node Q5.2.1, Q5.2.2, Q5.1.11, Miscellaneous
|
274
|
5709 @unnumberedsubsec Q5.2.1: How do I turn off the sound?
|
82
|
5710
|
|
5711 Add the following line to your @file{.emacs}:
|
|
5712
|
|
5713 @lisp
|
|
5714 (setq bell-volume 0)
|
|
5715 (setq sound-alist nil)
|
|
5716 @end lisp
|
|
5717
|
282
|
5718 That will make your XEmacs totally silent -- even the default ding sound
|
163
|
5719 (TTY beep on TTY-s) will be gone.
|
|
5720
|
227
|
5721 Starting with XEmacs-20.2 you can also change these with Customize.
|
|
5722 Select from the @code{Options} menu
|
|
5723 @code{Customize->Emacs->Environment->Sound->Sound...} or type
|
282
|
5724 @kbd{M-x customize @key{RET} sound @key{RET}}.
|
227
|
5725
|
|
5726
|
82
|
5727 @node Q5.2.2, Q5.2.3, Q5.2.1, Miscellaneous
|
274
|
5728 @unnumberedsubsec Q5.2.2: How do I get funky sounds instead of a boring beep?
|
82
|
5729
|
|
5730 Make sure your XEmacs was compiled with sound support, and then put this
|
|
5731 in your @file{.emacs}:
|
|
5732
|
|
5733 @lisp
|
|
5734 (load-default-sounds)
|
|
5735 @end lisp
|
|
5736
|
126
|
5737 The sound support in XEmacs 19.14 was greatly improved over previous
|
82
|
5738 versions.
|
|
5739
|
|
5740 @node Q5.2.3, Q5.2.4, Q5.2.2, Miscellaneous
|
274
|
5741 @unnumberedsubsec Q5.2.3: What's NAS, how do I get it?
|
82
|
5742
|
|
5743 @xref{Q2.0.3} for an explanation of the @dfn{Network Audio System}.
|
|
5744
|
|
5745 @node Q5.2.4, Q5.3.1, Q5.2.3, Miscellaneous
|
274
|
5746 @unnumberedsubsec Q5.2.4: Sunsite sounds don't play.
|
82
|
5747
|
|
5748 I'm having some trouble with sounds I've downloaded from sunsite. They
|
|
5749 play when I run them through @code{showaudio} or cat them directly to
|
|
5750 @file{/dev/audio}, but XEmacs refuses to play them.
|
|
5751
|
274
|
5752 @email{gutschk@@uni-muenster.de, Markus Gutschke} writes:
|
82
|
5753
|
|
5754 @quotation
|
|
5755 [Many of] These files have an (erroneous) 24byte header that tells about
|
|
5756 the format that they have been recorded in. If you cat them to
|
|
5757 @file{/dev/audio}, the header will be ignored and the default behavior
|
|
5758 for /dev/audio will be used. This happens to be 8kHz uLaw. It is
|
|
5759 probably possible to fix the header by piping through @code{sox} and
|
|
5760 passing explicit parameters for specifying the sampling format; you then
|
|
5761 need to perform a 'null' conversion from SunAudio to SunAudio.
|
|
5762 @end quotation
|
|
5763
|
|
5764 @node Q5.3.1, Q5.3.2, Q5.2.4, Miscellaneous
|
282
|
5765 @unnumberedsec 5.3: Miscellaneous
|
274
|
5766 @unnumberedsubsec Q5.3.1: How do you make XEmacs indent CL if-clauses correctly?
|
82
|
5767
|
|
5768 I'd like XEmacs to indent all the clauses of a Common Lisp @code{if} the
|
|
5769 same amount instead of indenting the 3rd clause differently from the
|
|
5770 first two.
|
70
|
5771
|
|
5772 One way is to add, to @file{.emacs}:
|
|
5773
|
82
|
5774 @lisp
|
70
|
5775 (put 'if 'lisp-indent-function nil)
|
82
|
5776 @end lisp
|
70
|
5777
|
227
|
5778 However, note that the package @code{cl-indent} that comes with
|
82
|
5779 XEmacs sets up this kind of indentation by default. @code{cl-indent}
|
|
5780 also knows about many other CL-specific forms. To use @code{cl-indent},
|
|
5781 one can do this:
|
|
5782
|
|
5783 @lisp
|
70
|
5784 (load "cl-indent")
|
|
5785 (setq lisp-indent-function (function common-lisp-indent-function))
|
82
|
5786 @end lisp
|
|
5787
|
|
5788 One can also customize @file{cl-indent.el} so it mimics the default
|
|
5789 @code{if} indentation @code{then} indented more than the @code{else}.
|
|
5790 Here's how:
|
|
5791
|
|
5792 @lisp
|
70
|
5793 (put 'if 'common-lisp-indent-function '(nil nil &body))
|
82
|
5794 @end lisp
|
70
|
5795
|
|
5796 Also, a new version (1.2) of @file{cl-indent.el} was posted to
|
82
|
5797 comp.emacs.xemacs on 12/9/94. This version includes more documentation
|
|
5798 than previous versions. This may prove useful if you need to customize
|
|
5799 any indent-functions.
|
|
5800
|
|
5801 @node Q5.3.2, Q5.3.3, Q5.3.1, Miscellaneous
|
274
|
5802 @unnumberedsubsec Q5.3.2: Fontifying hang when editing a postscript file.
|
82
|
5803
|
|
5804 When I try to edit a postscript file it gets stuck saying:
|
|
5805 @samp{fontifying 'filename' (regexps....)} and it just sits there. If I
|
|
5806 press @kbd{C-c} in the window where XEmacs was started, it suddenly
|
|
5807 becomes alive again.
|
70
|
5808
|
|
5809 This was caused by a bug in the Postscript font-lock regular
|
82
|
5810 expressions. It was fixed in 19.13. For earlier versions of XEmacs,
|
|
5811 have a look at your @file{.emacs} file. You will probably have a line
|
|
5812 like:
|
|
5813
|
|
5814 @lisp
|
70
|
5815 (add-hook 'postscript-mode-hook 'turn-on-font-lock)
|
82
|
5816 @end lisp
|
|
5817
|
|
5818 Take it out, restart XEmacs, and it won't try to fontify your postscript
|
|
5819 files anymore.
|
|
5820
|
|
5821 @node Q5.3.3, Q5.3.4, Q5.3.2, Miscellaneous
|
274
|
5822 @unnumberedsubsec Q5.3.3: How can I print WYSIWYG a font-locked buffer?
|
82
|
5823
|
|
5824 Font-lock looks nice. How can I print (WYSIWYG) the highlighted
|
|
5825 document?
|
|
5826
|
227
|
5827 The package @code{ps-print}, which is now included with XEmacs, provides
|
|
5828 the ability to do this. The source code contains complete instructions
|
282
|
5829 on its use, in @file{<xemacs_src_root>/lisp/packages/ps-print.el}.
|
82
|
5830
|
|
5831 @node Q5.3.4, Q5.3.5, Q5.3.3, Miscellaneous
|
274
|
5832 @unnumberedsubsec Q5.3.4: Getting @kbd{M-x lpr} to work with postscript printer.
|
82
|
5833
|
|
5834 My printer is a Postscript printer and @code{lpr} only works for
|
|
5835 Postscript files, so how do I get @kbd{M-x lpr-region} and @kbd{M-x
|
|
5836 lpr-buffer} to work?
|
|
5837
|
|
5838 Put something like this in your @file{.emacs}:
|
|
5839
|
|
5840 @lisp
|
|
5841 (setq lpr-command "a2ps")
|
|
5842 (setq lpr-switches '("-p" "-1"))
|
|
5843 @end lisp
|
|
5844
|
|
5845 If you don't use a2ps to convert ASCII to postscript (why not, it's
|
|
5846 free?), replace with the command you do use. Note also that some
|
|
5847 versions of a2ps require a @samp{-Pprinter} to ensure spooling.
|
|
5848
|
|
5849 @node Q5.3.5, Q5.3.6, Q5.3.4, Miscellaneous
|
274
|
5850 @unnumberedsubsec Q5.3.5: How do I specify the paths that XEmacs uses for finding files?
|
0
|
5851
|
|
5852 You can specify what paths to use by using a number of different flags
|
|
5853 when running configure. See the section MAKE VARIABLES in the top-level
|
|
5854 file INSTALL in the XEmacs distribution for a listing of those flags.
|
|
5855
|
82
|
5856 Most of the time, however, the simplest fix is: @strong{do not} specify
|
|
5857 paths as you might for GNU Emacs. XEmacs can generally determine the
|
0
|
5858 necessary paths dynamically at run time. The only path that generally
|
|
5859 needs to be specified is the root directory to install into. That can
|
|
5860 be specified by passing the @code{--prefix} flag to configure. For a
|
82
|
5861 description of the XEmacs install tree, please consult the @file{NEWS}
|
|
5862 file.
|
|
5863
|
|
5864 @node Q5.3.6, Q5.3.7, Q5.3.5, Miscellaneous
|
274
|
5865 @unnumberedsubsec Q5.3.6: [This question intentionally left blank]
|
82
|
5866
|
|
5867 Obsolete question, left blank to avoid renumbering.
|
|
5868
|
|
5869 @node Q5.3.7, Q5.3.8, Q5.3.6, Miscellaneous
|
274
|
5870 @unnumberedsubsec Q5.3.7: Can I have the end of the buffer delimited in some way?
|
82
|
5871
|
163
|
5872 Say, with: @samp{[END]}?
|
|
5873
|
|
5874 Try this:
|
|
5875
|
|
5876 @lisp
|
|
5877 (let ((ext (make-extent (point-min) (point-max))))
|
|
5878 (set-extent-property ext 'start-closed t)
|
|
5879 (set-extent-property ext 'end-closed t)
|
282
|
5880 (set-extent-property ext 'detachable nil)
|
163
|
5881 (set-extent-end-glyph ext (make-glyph [string :data "[END]"])))
|
|
5882 @end lisp
|
|
5883
|
|
5884 Since this is XEmacs, you can specify an icon to be shown on
|
|
5885 window-system devices. To do so, change the @code{make-glyph} call to
|
|
5886 something like this:
|
|
5887
|
|
5888 @lisp
|
|
5889 (make-glyph '([xpm :file "~/something.xpm"]
|
|
5890 [string :data "[END]"]))
|
|
5891 @end lisp
|
|
5892
|
|
5893 You can inline the @sc{xpm} definition yourself by specifying
|
|
5894 @code{:data} instead of @code{:file}. Here is such a full-featured
|
|
5895 version that works on both X and TTY devices:
|
82
|
5896
|
|
5897 @lisp
|
163
|
5898 (let ((ext (make-extent (point-min) (point-max))))
|
|
5899 (set-extent-property ext 'start-closed t)
|
|
5900 (set-extent-property ext 'end-closed t)
|
282
|
5901 (set-extent-property ext 'detachable nil)
|
163
|
5902 (set-extent-end-glyph ext (make-glyph '([xpm :data "\
|
|
5903 /* XPM */
|
|
5904 static char* eye = @{
|
|
5905 \"20 11 7 2\",
|
|
5906 \"__ c None\"
|
|
5907 \"_` c #7f7f7f\",
|
|
5908 \"_a c #fefefe\",
|
|
5909 \"_b c #7f0000\",
|
|
5910 \"_c c #fefe00\",
|
|
5911 \"_d c #fe0000\",
|
|
5912 \"_e c #bfbfbf\",
|
282
|
5913 \"___________`_`_`___b_b_b_b_________`____\",
|
|
5914 \"_________`_`_`___b_c_c_c_b_b____________\",
|
|
5915 \"_____`_`_`_e___b_b_c_c_c___b___b_______`\",
|
|
5916 \"___`_`_e_a___b_b_d___b___b___b___b______\",
|
|
5917 \"_`_`_e_a_e___b_b_d_b___b___b___b___b____\",
|
|
5918 \"_`_`_a_e_a___b_b_d___b___b___b___b___b__\",
|
|
5919 \"_`_`_e_a_e___b_b_d_b___b___b___b___b_b__\",
|
|
5920 \"___`_`_e_a___b_b_b_d_c___b___b___d_b____\",
|
|
5921 \"_____`_`_e_e___b_b_b_d_c___b_b_d_b______\",
|
|
5922 \"_`_____`_`_`_`___b_b_b_d_d_d_d_b________\",
|
|
5923 \"___`_____`_`_`_`___b_b_b_b_b_b__________\",
|
163
|
5924 @} ;"]
|
|
5925 [string :data "[END]"]))))
|
82
|
5926 @end lisp
|
|
5927
|
163
|
5928 Note that you might want to make this a function, and put it to a hook.
|
217
|
5929 We leave that as an exercise for the reader.
|
82
|
5930
|
|
5931 @node Q5.3.8, Q5.3.9, Q5.3.7, Miscellaneous
|
274
|
5932 @unnumberedsubsec Q5.3.8: How do I insert today's date into a buffer?
|
82
|
5933
|
|
5934 Like this:
|
|
5935
|
|
5936 @lisp
|
|
5937 (insert (current-time-string))
|
|
5938 @end lisp
|
|
5939
|
|
5940 @node Q5.3.9, Q5.3.10, Q5.3.8, Miscellaneous
|
274
|
5941 @unnumberedsubsec Q5.3.9: Are only certain syntactic character classes available for abbrevs?
|
|
5942
|
|
5943 @email{gutschk@@uni-muenster.de, Markus Gutschke} writes:
|
82
|
5944
|
|
5945 @quotation
|
|
5946 Yes, abbrevs only expands word-syntax strings. While XEmacs does not
|
|
5947 prevent you from defining (e.g. with @kbd{C-x a g} or @kbd{C-x a l})
|
|
5948 abbrevs that contain special characters, it will refuse to expand
|
|
5949 them. So you need to ensure, that the abbreviation contains letters and
|
|
5950 digits only. This means that @samp{xd}, @samp{d5}, and @samp{5d} are
|
|
5951 valid abbrevs, but @samp{&d}, and @samp{x d} are not.
|
|
5952
|
|
5953 If this sounds confusing to you, (re-)read the online documentation for
|
282
|
5954 abbrevs (@kbd{C-h i m XEmacs @key{RET} m Abbrevs @key{RET}}), and then come back and
|
82
|
5955 read this question/answer again.
|
|
5956 @end quotation
|
|
5957
|
227
|
5958 Starting with XEmacs 20.3 this restriction has been lifted.
|
163
|
5959
|
82
|
5960 @node Q5.3.10, Q5.3.11, Q5.3.9, Miscellaneous
|
274
|
5961 @unnumberedsubsec Q5.3.10: How can I get those oh-so-neat X-Face lines?
|
82
|
5962
|
|
5963 Firstly there is an ftp site which describes X-faces and has the
|
|
5964 associated tools mentioned below, at
|
274
|
5965 @uref{ftp://ftp.cs.indiana.edu:/pub/faces/}.
|
82
|
5966
|
|
5967 Then the steps are
|
|
5968
|
|
5969 @enumerate
|
|
5970 @item
|
|
5971 Create 48x48x1 bitmap with your favorite tool
|
|
5972
|
|
5973 @item
|
|
5974 Convert to "icon" format using one of xbm2ikon, pbmtoicon, etc.,
|
|
5975 and then compile the face.
|
|
5976
|
|
5977 @item
|
0
|
5978 @example
|
82
|
5979 cat file.xbm | xbm2ikon |compface > file.face
|
0
|
5980 @end example
|
|
5981
|
82
|
5982 @item
|
|
5983 Then be sure to quote things that are necessary for emacs strings:
|
0
|
5984
|
|
5985 @example
|
274
|
5986 cat ./file.face | sed 's/\\/\\\\/g'
|
|
5987 @iftex
|
|
5988 \ @*
|
282
|
5989 @end iftex
|
274
|
5990 | sed 's/\"/\\\"/g' > ./file.face.quoted
|
0
|
5991 @end example
|
|
5992
|
82
|
5993 @item
|
|
5994 Then set up emacs to include the file as a mail header - there were a
|
|
5995 couple of suggestions here---either something like:
|
|
5996
|
|
5997 @lisp
|
282
|
5998 (setq mail-default-headers
|
274
|
5999 "X-Face: @email{Ugly looking text string here}")
|
82
|
6000 @end lisp
|
|
6001
|
|
6002 Or, alternatively, as:
|
|
6003
|
|
6004 @lisp
|
|
6005 (defun mail-insert-x-face ()
|
282
|
6006 (save-excursion
|
82
|
6007 (goto-char (point-min))
|
|
6008 (search-forward mail-header-separator)
|
163
|
6009 (beginning-of-line)
|
82
|
6010 (insert "X-Face:")
|
163
|
6011 (insert-file-contents "~/.face")))
|
82
|
6012
|
|
6013 (add-hook 'mail-setup-hook 'mail-insert-x-face)
|
|
6014 @end lisp
|
|
6015 @end enumerate
|
|
6016
|
|
6017 However, 2 things might be wrong:
|
|
6018
|
|
6019 Some versions of pbmtoicon produces some header lines that is not
|
|
6020 expected by the version of compface that I grabbed. So I found I had to
|
|
6021 include a @code{tail +3} in the pipeline like this:
|
0
|
6022
|
|
6023 @example
|
82
|
6024 cat file.xbm | xbm2ikon | tail +3 |compface > file.face
|
0
|
6025 @end example
|
|
6026
|
82
|
6027 Some people have also found that if one uses the @code{(insert-file)}
|
|
6028 method, one should NOT quote the face string using the sed script .
|
|
6029
|
274
|
6030 It might also be helpful to use @email{stig@@hackvan.com, Stig's} script
|
82
|
6031 (included in the compface distribution at XEmacs.org) to do the
|
|
6032 conversion. For convenience xbm2xface is available for anonymous FTP at
|
274
|
6033 @uref{ftp://ftp.miranova.com/pub/xemacs/xbm2xface.pl}.
|
82
|
6034
|
|
6035 Contributors for this item:
|
|
6036
|
282
|
6037 Paul Emsley,
|
82
|
6038 Ricardo Marek,
|
|
6039 Amir J. Katz,
|
|
6040 Glen McCort,
|
282
|
6041 Heinz Uphoff,
|
82
|
6042 Peter Arius,
|
|
6043 Paul Harrison, and
|
|
6044 Vegard Vesterheim
|
|
6045
|
|
6046 @node Q5.3.11, Q5.3.12, Q5.3.10, Miscellaneous
|
274
|
6047 @unnumberedsubsec Q5.3.11: How do I add new Info directories?
|
82
|
6048
|
|
6049 You use something like:
|
|
6050
|
|
6051 @lisp
|
282
|
6052 (setq Info-directory-list (cons
|
274
|
6053 (expand-file-name "~/info")
|
|
6054 Info-default-directory-list))
|
82
|
6055 @end lisp
|
|
6056
|
274
|
6057 @email{davidm@@prism.kla.com, David Masterson} writes:
|
82
|
6058
|
|
6059 @quotation
|
|
6060 Emacs Info and XEmacs Info do many things differently. If you're trying to
|
|
6061 support a number of versions of Emacs, here are some notes to remember:
|
|
6062
|
|
6063 @enumerate
|
|
6064 @item
|
|
6065 Emacs Info scans @code{Info-directory-list} from right-to-left while
|
|
6066 XEmacs Info reads it from left-to-right, so append to the @emph{correct}
|
|
6067 end of the list.
|
|
6068
|
|
6069 @item
|
|
6070 Use @code{Info-default-directory-list} to initialize
|
|
6071 @code{Info-directory-list} @emph{if} it is available at startup, but not
|
|
6072 all Emacsen define it.
|
|
6073
|
|
6074 @item
|
|
6075 Emacs Info looks for a standard @file{dir} file in each of the
|
|
6076 directories scanned from #1 and magically concatenates them together.
|
|
6077
|
|
6078 @item
|
|
6079 XEmacs Info looks for a @file{localdir} file (which consists of just the
|
|
6080 menu entries from a @file{dir} file) in each of the directories scanned
|
217
|
6081 from #1 (except the first), does a simple concatenation of them, and
|
82
|
6082 magically attaches the resulting list to the end of the menu in the
|
|
6083 @file{dir} file in the first directory.
|
|
6084 @end enumerate
|
|
6085
|
|
6086 Another alternative is to convert the documentation to HTML with
|
|
6087 texi2html and read it from a web browser like Lynx or W3.
|
|
6088 @end quotation
|
|
6089
|
|
6090 @node Q5.3.12, , Q5.3.11, Miscellaneous
|
274
|
6091 @unnumberedsubsec Q5.3.12: What do I need to change to make printing work?
|
82
|
6092
|
|
6093 For regular printing there are two variables that can be customized.
|
|
6094
|
|
6095 @table @code
|
|
6096 @item lpr-command
|
|
6097 This should be set to a command that takes standard input and sends
|
|
6098 it to a printer. Something like:
|
|
6099
|
|
6100 @lisp
|
|
6101 (setq lpr-command "lp")
|
|
6102 @end lisp
|
|
6103
|
|
6104 @item lpr-switches
|
|
6105 This should be set to a list that contains whatever the print command
|
|
6106 requires to do its job. Something like:
|
|
6107
|
|
6108 @lisp
|
|
6109 (setq lpr-switches '("-depson"))
|
|
6110 @end lisp
|
|
6111 @end table
|
|
6112
|
|
6113 For postscript printing there are three analogous variables to
|
|
6114 customize.
|
|
6115
|
|
6116 @table @code
|
|
6117 @item ps-lpr-command
|
|
6118 This should be set to a command that takes postscript on standard input
|
|
6119 and directs it to a postscript printer.
|
|
6120
|
|
6121 @item ps-lpr-switches
|
|
6122 This should be set to a list of switches required for
|
|
6123 @code{ps-lpr-command} to do its job.
|
|
6124
|
|
6125 @item ps-print-color-p
|
|
6126 This boolean variable should be set @code{t} if printing will be done in
|
|
6127 color, otherwise it should be set to @code{nil}.
|
|
6128 @end table
|
|
6129
|
|
6130 NOTE: It is an undocumented limitation in XEmacs that postscript
|
|
6131 printing (the @code{Pretty Print Buffer} menu item) @strong{requires} a
|
|
6132 window system environment. It cannot be used outside of X11.
|
|
6133
|
|
6134 @node Current Events, , Miscellaneous, Top
|
274
|
6135 @unnumbered 6 What the Future Holds
|
82
|
6136
|
|
6137 This is part 6 of the XEmacs Frequently Asked Questions list. This
|
|
6138 section will change monthly, and contains any interesting items that have
|
|
6139 transpired over the previous month. If you are reading this from the
|
|
6140 XEmacs distribution, please see the version on the Web or archived at the
|
|
6141 various FAQ FTP sites, as this file is surely out of date.
|
|
6142
|
|
6143 @menu
|
163
|
6144 * Q6.0.1:: What is new in 20.2?
|
|
6145 * Q6.0.2:: What is new in 20.3?
|
282
|
6146 * Q6.0.3:: What is new in 20.4?
|
274
|
6147 * Q6.0.4:: Procedural changes in XEmacs development.
|
82
|
6148 @end menu
|
|
6149
|
163
|
6150 @node Q6.0.1, Q6.0.2, Current Events, Current Events
|
282
|
6151 @unnumberedsec 6.0: Changes
|
274
|
6152 @unnumberedsubsec Q6.0.1: What is new in 20.2?
|
163
|
6153
|
217
|
6154 The biggest changes in 20.2 include integration of EFS (the next
|
163
|
6155 generation of ange-ftp) and AUC Tex (the Emacs subsystem that includes a
|
126
|
6156 major mode for editing Tex and LaTeX, and a lot of other stuff). Many
|
163
|
6157 bugs from 20.0 have been fixed for this release. 20.2 also contains a
|
|
6158 new system for customizing XEmacs options, invoked via @kbd{M-x
|
|
6159 customize}.
|
|
6160
|
|
6161 XEmacs 20.2 is the development release (20.0 was beta), and is no longer
|
|
6162 considered unstable.
|
|
6163
|
|
6164 @node Q6.0.2, Q6.0.3, Q6.0.1, Current Events
|
274
|
6165 @unnumberedsubsec Q6.0.2: What is new in 20.3?
|
163
|
6166
|
227
|
6167 XEmacs 20.3 was released in November 1997. It contains many bugfixes,
|
|
6168 and a number of new features, including Autoconf 2 based configuration,
|
|
6169 additional support for Mule (Multi-language extensions to Emacs), many
|
|
6170 more customizations, multiple frames on TTY-s, support for multiple info
|
|
6171 directories, an enhanced gnuclient, improvements to regexp matching,
|
|
6172 increased MIME support, and many, many synches with GNU Emacs 20.
|
|
6173
|
|
6174 The XEmacs/Mule support has been only seriously tested in a Japanese
|
|
6175 locale, and no doubt many problems still remain. The support for
|
|
6176 ISO-Latin-1 and Japanese is fairly strong. MULE support comes at a
|
|
6177 price -- about a 30% slowdown from 19.16. We're making progress on
|
|
6178 improving performance and XEmacs 20.3 compiled without Mule (which is
|
|
6179 the default) is definitely faster than XEmacs 19.16.
|
|
6180
|
|
6181 XEmacs 20.3 is the first non-beta v20 release, and will be the
|
215
|
6182 basis for all further development.
|
|
6183
|
274
|
6184 @node Q6.0.3, Q6.0.4, Q6.0.2, Current Events
|
|
6185 @unnumberedsubsec Q6.0.3: What's new in XEmacs 20.4?
|
|
6186
|
|
6187 XEmacs 20.4 is a bugfix release with no user-visible changes.
|
|
6188 @c Filled in from NEWS file of 20.5-b33
|
|
6189
|
|
6190
|
|
6191 @node Q6.0.4, , Q6.0.3, Current Events
|
|
6192 @unnumberedsubsec Q6.0.4: Procedural changes in XEmacs development.
|
82
|
6193
|
|
6194 @enumerate
|
|
6195 @item
|
|
6196 Discussion about the development of XEmacs occurs on the xemacs-beta
|
|
6197 mailing list. Subscriptions to this list will now be fully automated
|
|
6198 instead of being handled by hand. Send a mail message to
|
282
|
6199 @email{xemacs-beta-request@@xemacs.org} with @samp{subscribe} as the
|
|
6200 BODY of the message to join the list. Please note this is a developers
|
|
6201 mailing list for people who have an active interest in the development
|
|
6202 process.
|
82
|
6203
|
215
|
6204 The discussion of NT XEmacs development is taking place on a separate
|
282
|
6205 mailing list. Send mail to
|
|
6206 @iftex
|
|
6207 @*
|
|
6208 @end iftex
|
274
|
6209 @email{xemacs-nt-request@@xemacs.org} to
|
215
|
6210 subscribe.
|
|
6211
|
82
|
6212 @item
|
|
6213 Due to the long development cycle in between releases, it has been
|
|
6214 decided that intermediate versions will be made available in source only
|
|
6215 form for the truly interested.
|
|
6216
|
215
|
6217 XEmacs 19.16 was the last 19 release, basically consisting of 19.15 plus
|
|
6218 the collected bugfixes.
|
82
|
6219
|
|
6220 @item
|
274
|
6221 As of December 1996, @email{steve@@altair.xemacs.org, Steve Baur} has become
|
82
|
6222 the lead maintainer of XEmacs.
|
163
|
6223 @end enumerate
|
82
|
6224
|
0
|
6225 @bye
|