XEmacs 21.2.46 "Urania".
[chise/xemacs-chise.git.1] / info / xemacs-faq.info-1
1 This is ../info/xemacs-faq.info, produced by makeinfo version 4.0 from
2 xemacs-faq.texi.
3
4 INFO-DIR-SECTION XEmacs Editor
5 START-INFO-DIR-ENTRY
6 * FAQ: (xemacs-faq).            XEmacs FAQ.
7 END-INFO-DIR-ENTRY
8
9 \1f
10 File: xemacs-faq.info,  Node: Top,  Next: Introduction,  Prev: (dir),  Up: (dir)
11
12 XEmacs FAQ
13 **********
14
15 Introduction
16 ************
17
18    This is the guide to the XEmacs Frequently Asked Questions list--a
19 compendium of questions and answers pertaining to one of the finest
20 programs ever written.  XEmacs is much more than just a Text Editor.
21
22    This FAQ is freely redistributable.  This FAQ is distributed in the
23 hope that it will be useful, but WITHOUT ANY WARRANTY; without even the
24 implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
25
26    If you have a Web browser, the official hypertext version is at
27 `http://www.xemacs.org/faq/xemacs-faq.html'
28
29 * Menu:
30
31 * Introduction::        Introduction, Policy, Credits.
32 * Installation::        Installation and Trouble Shooting.
33 * Customization::       Customization and Options.
34 * Subsystems::          Major Subsystems.
35 * Miscellaneous::       The Miscellaneous Stuff.
36 * MS Windows::          XEmacs on Microsoft Windows.
37 * Current Events::      What the Future Holds.
38
39
40  --- The Detailed Node Listing ---
41
42 Introduction, Policy, Credits
43
44 * Q1.0.1::      What is XEmacs?
45 * Q1.0.2::      What is the current version of XEmacs?
46 * Q1.0.3::      Where can I find it?
47 * Q1.0.4::      Why Another Version of Emacs?
48 * Q1.0.5::      Why Haven't XEmacs and GNU Emacs Merged?
49 * Q1.0.6::      Where can I get help?
50 * Q1.0.7::      Where are the mailing lists archived?
51 * Q1.0.8::      How do you pronounce XEmacs?
52 * Q1.0.9::      What does XEmacs look like?
53 * Q1.0.10::     Is there a port of XEmacs to Microsoft ('95 or NT)?
54 * Q1.0.11::     Is there a port of XEmacs to the Macintosh?
55 * Q1.0.12::     Is there a port of XEmacs to NextStep?
56 * Q1.0.13::     Is there a port of XEmacs to OS/2?
57 * Q1.0.14::     Where can I get a printed copy of the XEmacs users manual?
58
59 Policies:
60 * Q1.1.1::      What is the FAQ editorial policy?
61 * Q1.1.2::      How do I become a Beta Tester?
62 * Q1.1.3::      How do I contribute to XEmacs itself?
63
64 Credits:
65 * Q1.2.1::      Who wrote XEmacs?
66 * Q1.2.2::      Who contributed to this version of the FAQ?
67 * Q1.2.3::      Who contributed to the FAQ in the past?
68
69 Internationalization:
70 * Q1.3.1::      What is the status of internationalization support aka MULE (including Asian language support?
71 * Q1.3.2::      How can I help with internationalization?
72 * Q1.3.3::      How do I type non-ASCII characters?
73 * Q1.3.4::      Can XEmacs messages come out in a different language?
74 * Q1.3.5::      Please explain the various input methods in MULE/XEmacs
75 * Q1.3.6::      How do I portably code for MULE/XEmacs?
76 * Q1.3.7::      How about Cyrillic Modes?
77
78 Getting Started:
79 * Q1.4.1::      What is an `init.el' or `.emacs' and is there a sample one?
80 * Q1.4.2::      Can I use the same `init.el'/`.emacs' with the other Emacs?
81 * Q1.4.3::      Any good XEmacs tutorials around?
82 * Q1.4.4::      May I see an example of a useful XEmacs Lisp function?
83 * Q1.4.5::      And how do I bind it to a key?
84 * Q1.4.6::      What's the difference between a macro and a function?
85
86 Installation and Trouble Shooting
87
88 * Q2.0.1::      Running XEmacs without installing.
89 * Q2.0.2::      XEmacs is too big.
90 * Q2.0.3::      Compiling XEmacs with Netaudio.
91 * Q2.0.4::      Problems with Linux and ncurses.
92 * Q2.0.5::      Do I need X11 to run XEmacs?
93 * Q2.0.6::      I'm having strange crashes.  What do I do?
94 * Q2.0.7::      Libraries in non-standard locations.
95 * Q2.0.8::      can't resolve symbol _h_errno
96 * Q2.0.9::      Where do I find external libraries?
97 * Q2.0.10::     After I run configure I find a coredump, is something wrong?
98 * Q2.0.11::     XEmacs can't resolve host names.
99 * Q2.0.12::     Why can't I strip XEmacs?
100 * Q2.0.13::     I don't need no steenkin' packages.  Do I? (NEW)
101 * Q2.0.14::     How do I figure out which packages to install? (NEW)
102
103 Trouble Shooting:
104 * Q2.1.1::      XEmacs just crashed on me!
105 * Q2.1.2::      Cryptic Minibuffer messages.
106 * Q2.1.3::      Translation Table Syntax messages at Startup.
107 * Q2.1.4::      Startup warnings about deducing proper fonts?
108 * Q2.1.5::      XEmacs cannot connect to my X Terminal.
109 * Q2.1.6::      XEmacs just locked up my Linux X server.
110 * Q2.1.7::      HP Alt key as Meta.
111 * Q2.1.8::      got (wrong-type-argument color-instance-p nil)!
112 * Q2.1.9::      XEmacs causes my OpenWindows 3.0 server to crash.
113 * Q2.1.10::     Warnings from incorrect key modifiers.
114 * Q2.1.11::     Can't instantiate image error... in toolbar
115 * Q2.1.12::     Regular Expression Problems on DEC OSF1.
116 * Q2.1.13::     HP/UX 10.10 and `create_process' failure
117 * Q2.1.14::     C-g doesn't work for me.  Is it broken?
118 * Q2.1.15::     How to debug an XEmacs problem with a debugger.
119 * Q2.1.16::     XEmacs crashes in `strcat' on HP/UX 10.
120 * Q2.1.17::     `Marker does not point anywhere'.
121 * Q2.1.18::     [This question intentionally left blank]
122 * Q2.1.19::     XEmacs does not follow the local timezone.
123 * Q2.1.20::     `Symbol's function definition is void: hkey-help-show.'
124 * Q2.1.21::     [This question intentionally left blank]
125 * Q2.1.22::     XEmacs seems to take a really long time to do some things.
126 * Q2.1.23::     Movemail on Linux does not work for XEmacs 19.15 and later.
127 * Q2.1.24::     XEmacs won't start without network. (NEW)
128 * Q2.1.25::     After upgrading, XEmacs won't do `foo' any more! (NEW)
129
130 Customization and Options
131
132 * Q3.0.1::      What version of Emacs am I running?
133 * Q3.0.2::      How do I evaluate Elisp expressions?
134 * Q3.0.3::      `(setq tab-width 6)' behaves oddly.
135 * Q3.0.4::      How can I add directories to the `load-path'?
136 * Q3.0.5::      How to check if a lisp function is defined?
137 * Q3.0.6::      Can I force the output of `(face-list)' to a buffer?
138 * Q3.0.7::      Font selections don't get saved after `Save Options'.
139 * Q3.0.8::      How do I make a single minibuffer frame?
140 * Q3.0.9::      What is `Customize'?
141
142 X Window System & Resources:
143 * Q3.1.1::      Where is a list of X resources?
144 * Q3.1.2::      How can I detect a color display?
145 * Q3.1.3::      [This question intentionally left blank]
146 * Q3.1.4::      [This question intentionally left blank]
147 * Q3.1.5::      How can I get the icon to just say `XEmacs'?
148 * Q3.1.6::      How can I have the window title area display the full path?
149 * Q3.1.7::      `xemacs -name junk' doesn't work?
150 * Q3.1.8::      `-iconic' doesn't work.
151
152 Textual Fonts & Colors:
153 * Q3.2.1::      How can I set color options from `init.el'/`.emacs'?
154 * Q3.2.2::      How do I set the text, menu and modeline fonts?
155 * Q3.2.3::      How can I set the colors when highlighting a region?
156 * Q3.2.4::      How can I limit color map usage?
157 * Q3.2.5::      My tty supports color, but XEmacs doesn't use them.
158 * Q3.2.6::      Can I have pixmap backgrounds in XEmacs?
159
160 The Modeline:
161 * Q3.3.1::      How can I make the modeline go away?
162 * Q3.3.2::      How do you have XEmacs display the line number in the modeline?
163 * Q3.3.3::      How do I get XEmacs to put the time of day on the modeline?
164 * Q3.3.4::      How do I turn off current chapter from AUC TeX modeline?
165 * Q3.3.5::      How can one change the modeline color based on the mode used?
166
167 Multiple Device Support:
168 * Q3.4.1::      How do I open a frame on another screen of my multi-headed display?
169 * Q3.4.2::      Can I really connect to a running XEmacs after calling up over a modem?  How?
170
171 The Keyboard:
172 * Q3.5.1::      How can I bind complex functions (or macros) to keys?
173 * Q3.5.2::      How can I stop down-arrow from adding empty lines to the bottom of my buffers?
174 * Q3.5.3::      How do I bind C-. and C-; to scroll one line up and down?
175 * Q3.5.4::      Globally binding Delete?
176 * Q3.5.5::      Scrolling one line at a time.
177 * Q3.5.6::      How to map Help key alone on Sun type4 keyboard?
178 * Q3.5.7::      How can you type in special characters in XEmacs?
179 * Q3.5.8::      [This question intentionally left blank]
180 * Q3.5.9::      How do I make the Delete key delete forward?
181 * Q3.5.10::     Can I turn on "sticky" modifier keys?
182 * Q3.5.11::     How do I map the arrow keys?
183
184 The Cursor:
185 * Q3.6.1::      Is there a way to make the bar cursor thicker?
186 * 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?
187 * Q3.6.3::      Can I make the cursor blink?
188
189 The Mouse and Highlighting:
190 * Q3.7.1::      How can I turn off Mouse pasting?
191 * Q3.7.2::      How do I set control/meta/etc modifiers on mouse buttons?
192 * Q3.7.3::      Clicking the left button does not do anything in buffer list.
193 * Q3.7.4::      How can I get a list of buffers when I hit mouse button 3?
194 * Q3.7.5::      Why does cut-and-paste not work between XEmacs and a cmdtool?
195 * Q3.7.6::      How I can set XEmacs up so that it pastes where the text cursor is?
196 * Q3.7.7::      How do I select a rectangular region?
197 * Q3.7.8::      Why does M-w take so long?
198
199 The Menubar and Toolbar:
200 * Q3.8.1::      How do I get rid of the menu (or menubar)?
201 * Q3.8.2::      Can I customize the basic menubar?
202 * Q3.8.3::      How do I control how many buffers are listed in the menu `Buffers' list?
203 * Q3.8.4::      Resources like `Emacs*menubar*font' are not working?
204 * Q3.8.5::      How can I bind a key to a function to toggle the toolbar?
205
206 Scrollbars:
207 * Q3.9.1::      How can I disable the scrollbar?
208 * Q3.9.2::      How can one use resources to change scrollbar colors?
209 * Q3.9.3::      Moving the scrollbar can move the point; can I disable this?
210 * Q3.9.4::      How can I turn off automatic horizontal scrolling in specific modes?
211
212 Text Selections:
213 * Q3.10.1::     How can I turn off or change highlighted selections?
214 * Q3.10.2::     How do I get that typing on an active region removes it?
215 * Q3.10.3::     Can I turn off the highlight during isearch?
216 * Q3.10.4::     How do I turn off highlighting after C-x C-p (mark-page)?
217 * Q3.10.5::     The region disappears when I hit the end of buffer while scrolling.
218
219 Major Subsystems
220
221 * Q4.0.1::      How do I set up VM to retrieve remote mail using POP?
222 * Q4.0.2::      How do I get VM to filter mail for me?
223 * Q4.0.3::      How can I get VM to automatically check for new mail?
224 * Q4.0.4::      [This question intentionally left blank]
225 * Q4.0.5::      How do I get my outgoing mail archived?
226 * 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"?
227 * Q4.0.7::      Is there a mailing list or FAQ for VM?
228 * Q4.0.8::      Remote mail reading with VM.
229 * Q4.0.9::      rmail or VM gets an error incorporating new mail.
230 * Q4.0.10::     How do I make VM stay in a single frame?
231 * Q4.0.11::     How do I make VM or mh-e display graphical smilies?
232 * Q4.0.12::     Customization of VM not covered in the manual or here.
233
234 Web browsing with W3:
235 * Q4.1.1::      What is W3?
236 * Q4.1.2::      How do I run W3 from behind a firewall?
237 * Q4.1.3::      Is it true that W3 supports style sheets and tables?
238
239 Reading Netnews and Mail with Gnus:
240 * Q4.2.1::      GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus, Quassia Gnus, argh!
241 * Q4.2.2::      [This question intentionally left blank]
242 * Q4.2.3::      How do I make Gnus stay within a single frame?
243 * Q4.2.4::      How do I customize the From: line?
244
245 Other Mail & News:
246 * Q4.3.1::      How can I read and/or compose MIME messages?
247 * Q4.3.2::      What is TM and where do I get it?
248 * Q4.3.3::      Why isn't this `movemail' program working?
249 * Q4.3.4::      Movemail is also distributed by Netscape?  Can that cause problems?
250 * Q4.3.5::      Where do I find pstogif (required by tm)?
251
252 Sparcworks, EOS, and WorkShop:
253 * Q4.4.1::      What is SPARCworks, EOS, and WorkShop
254 * Q4.4.2::      How do I start the Sun Workshop support in XEmacs 21?
255
256 Energize:
257 * Q4.5.1::      What is/was Energize?
258
259 Infodock:
260 * Q4.6.1::      What is Infodock?
261
262 Other Unbundled Packages:
263 * Q4.7.1::      What is AUC TeX?  Where do you get it?
264 * Q4.7.2::      Are there any Emacs Lisp Spreadsheets?
265 * Q4.7.3::      [This question intentionally left blank]
266 * Q4.7.4::      Problems installing AUC TeX
267 * Q4.7.5::      Is there a reason for an Emacs package not to be included in XEmacs?
268 * Q4.7.6::      Is there a MatLab mode?
269
270 The Miscellaneous Stuff
271
272 * Q5.0.1::      How can I do source code highlighting using font-lock?
273 * Q5.0.2::      I do not like cc-mode.  How do I use the old c-mode?
274 * Q5.0.3::      How do I get `More' Syntax Highlighting on by default?
275 * Q5.0.4::      How can I enable auto-indent and/or Filladapt?
276 * Q5.0.5::      How can I get XEmacs to come up in text/auto-fill mode by default?
277 * Q5.0.6::      How do I start up a second shell buffer?
278 * Q5.0.7::      Telnet from shell filters too much.
279 * Q5.0.8::      Why does edt emulation not work?
280 * Q5.0.9::      How can I emulate VI and use it as my default mode?
281 * Q5.0.10::     [This question intentionally left blank]
282 * Q5.0.11::     [This question intentionally left blank]
283 * Q5.0.12::     How do I disable gnuserv from opening a new frame?
284 * Q5.0.13::     How do I start gnuserv so that each subsequent XEmacs is a client?
285 * Q5.0.14::     Strange things are happening in Shell Mode.
286 * Q5.0.15::     Where do I get the latest CC Mode?
287 * Q5.0.16::     I find auto-show-mode disconcerting.  How do I turn it off?
288 * Q5.0.17::     How can I get two instances of info?
289 * Q5.0.18::     [This question intentionally left blank]
290 * Q5.0.19::     Is there something better than LaTeX mode?
291 * Q5.0.20::     Is there a way to start a new XEmacs if there's no gnuserv running, and otherwise use gnuclient?
292
293 Emacs Lisp Programming Techniques:
294 * Q5.1.1::      The difference in key sequences between XEmacs and GNU Emacs?
295 * Q5.1.2::      Can I generate "fake" keyboard events?
296 * Q5.1.3::      Could you explain `read-kbd-macro' in more detail?
297 * Q5.1.4::      What is the performance hit of `let'?
298 * Q5.1.5::      What is the recommended use of `setq'?
299 * Q5.1.6::      What is the typical misuse of `setq' ?
300 * Q5.1.7::      I like the `do' form of cl, does it slow things down?
301 * Q5.1.8::      I like recursion, does it slow things down?
302 * Q5.1.9::      How do I put a glyph as annotation in a buffer?
303 * Q5.1.10::     `map-extents' won't traverse all of my extents!
304 * Q5.1.11::     My elisp program is horribly slow.  Is there an easy way to find out where it spends time?
305
306 Sound:
307 * Q5.2.1::      How do I turn off the sound?
308 * Q5.2.2::      How do I get funky sounds instead of a boring beep?
309 * Q5.2.3::      What's NAS, how do I get it?
310 * Q5.2.4::      Sunsite sounds don't play.
311
312 Miscellaneous:
313 * Q5.3.1::      How do you make XEmacs indent CL if-clauses correctly?
314 * Q5.3.2::      [This question intentionally left blank]
315 * Q5.3.3::      How can I print WYSIWYG a font-locked buffer?
316 * Q5.3.4::      Getting M-x lpr to work with postscript printer.
317 * Q5.3.5::      How do I specify the paths that XEmacs uses for finding files?
318 * Q5.3.6::      [This question intentionally left blank]
319 * Q5.3.7::      Can I have the end of the buffer delimited in some way?
320 * Q5.3.8::      How do I insert today's date into a buffer?
321 * Q5.3.9::      Are only certain syntactic character classes available for abbrevs?
322 * Q5.3.10::     How can I get those oh-so-neat X-Face lines?
323 * Q5.3.11::     How do I add new Info directories?
324 * Q5.3.12::     What do I need to change to make printing work?
325
326 XEmacs on MS Windows
327
328 General Info:
329 * Q6.0.1::      What is the status of the XEmacs port to Windows?
330 * Q6.0.2::      What flavors of MS Windows are supported?
331 * Q6.0.3::      Are binaries available?
332 * Q6.0.4::      Can I build XEmacs on MS Windows with support for X or Cygwin?
333
334 Building XEmacs on MS Windows:
335 * Q6.1.1::      I decided to run with X.  Where do I get an X server?
336 * Q6.1.2::      What compiler do I need to compile XEmacs?
337 * Q6.1.3::      How do I compile for the native port?
338 * Q6.1.4::      How do I compile for the X port?
339 * Q6.1.5::      How do I compile for Cygnus' Cygwin?
340 * Q6.1.6::      What do I need for Cygwin?
341
342 Customization and User Interface:
343 * Q6.2.1::      How will the port cope with differences in the Windows user interface?
344 * Q6.2.2::      How do I change fonts in XEmacs on MS Windows?
345 * Q6.2.3::      Where do I put my `init.el'/`.emacs' file?
346
347 Miscellaneous:
348 * Q6.3.1::      Will XEmacs rename all the win32-* symbols to w32-*?
349 * Q6.3.2::      What are the differences between the various MS Windows emacsen?
350 * Q6.3.3::      What is the porting team doing at the moment?
351
352 Troubleshooting:
353 * Q6.4.1::      XEmacs won't start on Windows. (NEW)
354
355 Current Events:
356
357 * Q7.0.1::      What is new in 20.2?
358 * Q7.0.2::      What is new in 20.3?
359 * Q7.0.3::      What is new in 20.4?
360 * Q7.0.4::      Procedural changes in XEmacs development.
361
362 \1f
363 File: xemacs-faq.info,  Node: Introduction,  Next: Installation,  Prev: Top,  Up: Top
364
365 1 Introduction, Policy, Credits
366 *******************************
367
368    Learning XEmacs is a lifelong activity.  Even people who have used
369 Emacs for years keep discovering new features.  Therefore this document
370 cannot be complete.  Instead it is aimed at the person who is either
371 considering XEmacs for their own use, or has just obtained it and is
372 wondering what to do next.  It is also useful as a reference to
373 available resources.
374
375    The previous maintainer of the FAQ was Anthony Rossini
376 <rossini@biostat.washington.edu>, who started it, after getting tired
377 of hearing JWZ complain about repeatedly having to answer questions.
378 Ben Wing <ben@xemacs.org> and Chuck Thompson <cthomp@xemacs.org>, the
379 principal authors of XEmacs, then took over and Ben did a massive
380 update reorganizing the whole thing.  At which point Anthony took back
381 over, but then had to give it up again.  Some of the other contributors
382 to this FAQ are listed later in this document.
383
384    The previous version was converted to hypertext format, and edited by
385 Steven L. Baur <steve@xemacs.org>.  It was converted back to texinfo by
386 Hrvoje Niksic <hniksic@xemacs.org>.  The FAQ was then maintained by
387 Andreas Kaempf <andreas@sccon.com>, who passed it on to ChristianNyb/o.
388
389    If you notice any errors or items which should be added or amended to
390 this FAQ please send email to Sandra Wambold <faq@xemacs.org>.  Include
391 `XEmacs FAQ' on the Subject: line.
392
393 * Menu:
394
395 Introduction:
396 * Q1.0.1::      What is XEmacs?
397 * Q1.0.2::      What is the current version of XEmacs?
398 * Q1.0.3::      Where can I find it?
399 * Q1.0.4::      Why Another Version of Emacs?
400 * Q1.0.5::      Why Haven't XEmacs and GNU Emacs Merged?
401 * Q1.0.6::      Where can I get help?
402 * Q1.0.7::      Where are the mailing lists archived?
403 * Q1.0.8::      How do you pronounce XEmacs?
404 * Q1.0.9::      What does XEmacs look like?
405 * Q1.0.10::     Is there a port of XEmacs to Microsoft ('95 or NT)?
406 * Q1.0.11::     Is there a port of XEmacs to the Macintosh?
407 * Q1.0.12::     Is there a port of XEmacs to NextStep?
408 * Q1.0.13::     Is there a port of XEmacs to OS/2?
409 * Q1.0.14::     Where can I get a printed copy of the XEmacs users manual?
410
411 Policies:
412 * Q1.1.1::      What is the FAQ editorial policy?
413 * Q1.1.2::      How do I become a Beta Tester?
414 * Q1.1.3::      How do I contribute to XEmacs itself?
415
416 Credits:
417 * Q1.2.1::      Who wrote XEmacs?
418 * Q1.2.2::      Who contributed to this version of the FAQ?
419 * Q1.2.3::      Who contributed to the FAQ in the past?
420
421 Internationalization:
422 * Q1.3.1::      What is the status of internationalization support aka MULE (including Asian language support?
423 * Q1.3.2::      How can I help with internationalization?
424 * Q1.3.3::      How do I type non-ASCII characters?
425 * Q1.3.4::      Can XEmacs messages come out in a different language?
426 * Q1.3.5::      Please explain the various input methods in MULE/XEmacs
427 * Q1.3.6::      How do I portably code for MULE/XEmacs?
428 * Q1.3.7::      How about Cyrillic Modes?
429
430 Getting Started:
431 * Q1.4.1::      What is an `init.el' or `.emacs' and is there a sample one?
432 * Q1.4.2::      Can I use the same `init.el'/`.emacs' with the other Emacs?
433 * Q1.4.3::      Any good XEmacs tutorials around?
434 * Q1.4.4::      May I see an example of a useful XEmacs Lisp function?
435 * Q1.4.5::      And how do I bind it to a key?
436 * Q1.4.6::      What's the difference between a macro and a function?
437
438 \1f
439 File: xemacs-faq.info,  Node: Q1.0.1,  Next: Q1.0.2,  Prev: Introduction,  Up: Introduction
440
441 1.0: Introduction
442 =================
443
444 Q1.0.1: What is XEmacs?
445 -----------------------
446
447    XEmacs is a highly customizable open source text editor and
448 application development system.  It is protected under the GNU Public
449 License and related to other versions of Emacs, in particular GNU
450 Emacs.  Its emphasis is on modern graphical user interface support and
451 an open software development model, similar to Linux.  XEmacs has an
452 active development community numbering in the hundreds, and runs on
453 Windows 95 and NT, Linux and nearly every other version of Unix in
454 existence.  Support for XEmacs has been supplied by Sun Microsystems,
455 University of Illinois, Lucid, ETL/Electrotechnical Laboratory, Amdahl
456 Corporation, BeOpen, and others, as well as the unpaid time of a great
457 number of individual developers.
458
459 \1f
460 File: xemacs-faq.info,  Node: Q1.0.2,  Next: Q1.0.3,  Prev: Q1.0.1,  Up: Introduction
461
462 Q1.0.2: What is the current version of XEmacs?
463 ----------------------------------------------
464
465    XEmacs versions 21.1.* are releases made from the current stable
466 sources.  XEmacs versions 21.2.* are releases made from the development
467 sources.  Check at `http://www.xemacs.org' for the current minor
468 version.
469
470    XEmacs 19.16 was the last release of v19, released in November, 1997,
471 which was also the last version without international language support.
472
473 \1f
474 File: xemacs-faq.info,  Node: Q1.0.3,  Next: Q1.0.4,  Prev: Q1.0.2,  Up: Introduction
475
476 Q1.0.3: Where can I find it?
477 ----------------------------
478
479    The canonical source and binaries can be found via anonymous FTP at:
480
481      `ftp://ftp.xemacs.org/pub/xemacs/'
482
483 \1f
484 File: xemacs-faq.info,  Node: Q1.0.4,  Next: Q1.0.5,  Prev: Q1.0.3,  Up: Introduction
485
486 Q1.0.4: Why Another Version of Emacs?
487 -------------------------------------
488
489    For a detailed description of the differences between GNU Emacs and
490 XEmacs and a detailed history of XEmacs, check out the
491      NEWS file (http://www.xemacs.org/About/XEmacsVsGNUemacs.html)
492
493    However, here is a list of some of the reasons why we think you might
494 consider using it:
495
496    * It looks nicer.
497
498    * The XEmacs maintainers are generally more receptive to suggestions
499      than the GNU Emacs maintainers.
500
501    * Many more bundled packages than GNU Emacs.
502
503    * Binaries are available for many common operating systems.
504
505    * Face support on TTY's.
506
507    * A built-in toolbar.
508
509    * Better Motif compliance.
510
511    * Some internationalization support (including full MULE support, if
512      compiled with it).
513
514    * Variable-width fonts.
515
516    * Variable-height lines.
517
518    * Marginal annotations.
519
520    * ToolTalk support.
521
522    * XEmacs can be used as an Xt widget, and can be embedded within
523      another application.
524
525    * Horizontal and vertical scrollbars (using real toolkit scrollbars).
526
527    * Better APIs (and performance) for attaching fonts, colors, and
528      other properties to text.
529
530    * The ability to embed arbitrary graphics in a buffer.
531
532    * Completely compatible (at the C level) with the Xt-based toolkits.
533
534
535 \1f
536 File: xemacs-faq.info,  Node: Q1.0.5,  Next: Q1.0.6,  Prev: Q1.0.4,  Up: Introduction
537
538 Q1.0.5: Why Haven't XEmacs and GNU Emacs Merged?
539 ------------------------------------------------
540
541    There are currently irreconcilable differences in the views about
542 technical, programming, design and organizational matters between RMS
543 and the XEmacs development team which provide little hope for a merge to
544 take place in the short-term future.
545
546    If you have a comment to add regarding the merge, it is a good idea
547 to avoid posting to the newsgroups,  because of the very heated
548 flamewars that often result.  Mail your questions to
549 <xemacs-beta@xemacs.org> and <bug-gnu-emacs@prep.ai.mit.edu>.
550
551 \1f
552 File: xemacs-faq.info,  Node: Q1.0.6,  Next: Q1.0.7,  Prev: Q1.0.5,  Up: Introduction
553
554 Q1.0.6: Where can I get help?
555 -----------------------------
556
557    Probably the easiest way, if everything is installed, is to use
558 Info, by pressing `C-h i', or looking for an Info item on the Help
559 Menu.  `M-x apropos' can be used to look for particular commands.
560
561    For items not found in the manual, try reading this FAQ and reading
562 the Usenet group comp.emacs.xemacs.
563
564    If you choose to post to a newsgroup, *please use
565 comp.emacs.xemacs*.  Please do not post XEmacs related questions to
566 gnu.emacs.help.
567
568    If you cannot post or read Usenet news, there is a corresponding
569 mailing list which is available.  It can be subscribed to by sending a
570 message to <xemacs-request@xemacs.org> with `subscribe' in the body of
571 the message.  Send to the list at <xemacs@xemacs.org>.  list.  To
572 cancel a subscription, you *must* use the xemacs-request address.  Send
573 a message with a subject of `unsubscribe' to be removed.
574
575 \1f
576 File: xemacs-faq.info,  Node: Q1.0.7,  Next: Q1.0.8,  Prev: Q1.0.6,  Up: Introduction
577
578 Q1.0.7: Where are the mailing lists archived?
579 ---------------------------------------------
580
581    The archives can be found at `http://list-archive.xemacs.org'
582
583 \1f
584 File: xemacs-faq.info,  Node: Q1.0.8,  Next: Q1.0.9,  Prev: Q1.0.7,  Up: Introduction
585
586 Q1.0.8: How do you pronounce XEmacs?
587 ------------------------------------
588
589    The most common pronounciation is `Eks eemax'.
590
591 \1f
592 File: xemacs-faq.info,  Node: Q1.0.9,  Next: Q1.0.10,  Prev: Q1.0.8,  Up: Introduction
593
594 Q1.0.9: What does XEmacs look like?
595 -----------------------------------
596
597    Screen snapshots are available in the WWW version of the FAQ.
598      `http://www.xemacs.org/faq/xemacs-faq.html'
599
600 \1f
601 File: xemacs-faq.info,  Node: Q1.0.10,  Next: Q1.0.11,  Prev: Q1.0.9,  Up: Introduction
602
603 Q1.0.10: Is there a port of XEmacs to Microsoft ('95 or NT)?
604 ------------------------------------------------------------
605
606    Yes, *Note MS Windows::.
607
608 \1f
609 File: xemacs-faq.info,  Node: Q1.0.11,  Next: Q1.0.12,  Prev: Q1.0.10,  Up: Introduction
610
611 Q1.0.11: Is there a port of XEmacs to the Macintosh?
612 ----------------------------------------------------
613
614    Yes, there is a port of XEmacs 19.14, tested on MacOS 7.6.1 and MacOS
615 8.5.1 by Pitts Jarvis <pjarvis@ispchannel.com>.  It's available at
616 `http://homepage.mac.com/pjarvis/xemacs.html'.
617
618 \1f
619 File: xemacs-faq.info,  Node: Q1.0.12,  Next: Q1.0.13,  Prev: Q1.0.11,  Up: Introduction
620
621 Q1.0.12: Is there a port of XEmacs to NextStep?
622 -----------------------------------------------
623
624    Carl Edman, apparently no longer at <cedman@princeton.edu>, did the
625 port of GNU Emacs to NeXTstep and expressed interest in doing the
626 XEmacs port, but never went any farther.
627
628 \1f
629 File: xemacs-faq.info,  Node: Q1.0.13,  Next: Q1.0.14,  Prev: Q1.0.12,  Up: Introduction
630
631 Q1.0.13: Is there a port of XEmacs to OS/2?
632 -------------------------------------------
633
634    No, but Alexander Nikolaev <avn_1251@mail.ru> is working on it.
635
636 \1f
637 File: xemacs-faq.info,  Node: Q1.0.14,  Next: Q1.1.1,  Prev: Q1.0.13,  Up: Introduction
638
639 Q1.0.14: Where can I obtain a printed copy of the XEmacs User's Manual?
640 -----------------------------------------------------------------------
641
642    Pre-printed manuals are not available.  If you are familiar with
643 TeX, you can generate your own manual from the XEmacs sources.
644
645    HTML and Postscript versions of XEmacs manuals may be available from
646 the XEmacs web site in the future.  Send requests to <faq@xemacs.org>.
647
648 \1f
649 File: xemacs-faq.info,  Node: Q1.1.1,  Next: Q1.1.2,  Prev: Q1.0.14,  Up: Introduction
650
651 1.1: Policies
652 =============
653
654 Q1.1.1: What is the FAQ editorial policy?
655 -----------------------------------------
656
657    The FAQ is actively maintained and modified regularly.  All links
658 should be up to date.  Unfortunately, some of the information is out of
659 date - a situation which the FAQ maintainer is working on.  All
660 submissions are welcome, please e-mail submissions to XEmacs FAQ
661 maintainers <faq@xemacs.org>.
662
663    Please make sure that `XEmacs FAQ' appears on the Subject: line.  If
664 you think you have a better way of answering a question, or think a
665 question should be included, we'd like to hear about it.  Questions and
666 answers included into the FAQ will be edited for spelling and grammar
667 and will be attributed.  Answers appearing without attribution are
668 either from versions of the FAQ dated before May 1996 or are from
669 previous FAQ maintainers.  Answers quoted from Usenet news articles will
670 always be attributed, regardless of the author.
671
672 \1f
673 File: xemacs-faq.info,  Node: Q1.1.2,  Next: Q1.1.3,  Prev: Q1.1.1,  Up: Introduction
674
675 Q1.1.2: How do I become a Beta Tester?
676 --------------------------------------
677
678    Send an email message to <xemacs-beta-request@xemacs.org> with the
679 line `subscribe' in the body of the message.
680
681    Be prepared to get your hands dirty, as beta testers are expected to
682 identify problems as best they can.
683
684 \1f
685 File: xemacs-faq.info,  Node: Q1.1.3,  Next: Q1.2.1,  Prev: Q1.1.2,  Up: Introduction
686
687 Q1.1.3: How do I contribute to XEmacs itself?
688 ---------------------------------------------
689
690    Ben Wing <ben@xemacs.org> writes:
691
692      BTW if you have a wish list of things that you want added, you
693      have to speak up about it!  More specifically, you can do the
694      following if you want a feature added (in increasing order of
695      usefulness):
696
697         * Make a posting about a feature you want added.
698
699         * Become a beta tester and make more postings about those same
700           features.
701
702         * Convince us that you're going to use the features in some
703           cool and useful way.
704
705         * Come up with a clear and well-thought-out API concerning the
706           features.
707
708         * Write the code to implement a feature and send us a patch.
709
710      (not that we're necessarily requiring you to write the code, but
711      we can always hope :)
712
713 \1f
714 File: xemacs-faq.info,  Node: Q1.2.1,  Next: Q1.2.2,  Prev: Q1.1.3,  Up: Introduction
715
716 1.2: Credits
717 ============
718
719 Q1.2.1: Who wrote XEmacs?
720 -------------------------
721
722    XEmacs is the result of the time and effort of many people.  The
723 developers responsible for recent releases are:
724
725    * Martin Buchholz <martin@xemacs.org>
726
727    * Steven Turnbull <turnbull@sk.tsukuba.ac.jp>
728
729    * Ben Wing <ben@xemacs.org>
730
731    * Hrvoje Niksic <hniksic@xemacs.org>
732
733
734    The developers responsible for older releases were:
735
736    * Steve Baur <steve@xemacs.org>
737
738    * Chuck Thompson <cthomp@xemacs.org>
739
740    * Jamie Zawinski <jwz@jwz.org>
741
742    * Richard Mlynarik <mly@adoc.xerox.com>
743
744      Steve Baur was the primary maintainer for 19.15 through 21.0.
745
746      Chuck Thompson and Ben Wing were the maintainers for 19.11 through
747      19.14 and heavy code contributors for 19.8 through 19.10.
748
749      Jamie Zawinski was the maintainer for 19.0 through 19.10 (the
750      entire history of Lucid Emacs).  Richard Mlynarik was a heavy code
751      contributor to 19.6 through 19.8.
752
753
754    Along with many other contributors, partially enumerated in the
755 `About XEmacs' option in the Help menu.
756
757 \1f
758 File: xemacs-faq.info,  Node: Q1.2.2,  Next: Q1.2.3,  Prev: Q1.2.1,  Up: Introduction
759
760 Q1.2.2: Who contributed to this version of the FAQ?
761 ---------------------------------------------------
762
763    The following people contributed valuable suggestions to building
764 this version of the FAQ (listed in alphabetical order):
765
766    * SL Baur <steve@xemacs.org>
767
768    * Hrvoje Niksic <hniksic@xemacs.org>
769
770    * Aki Vehtari <Aki.Vehtari@hut.fi>
771
772
773 \1f
774 File: xemacs-faq.info,  Node: Q1.2.3,  Next: Q1.3.1,  Prev: Q1.2.2,  Up: Introduction
775
776 Q1.2.3: Who contributed to the FAQ in the past?
777 -----------------------------------------------
778
779    This is only a partial list, as many names were lost in a hard disk
780 crash some time ago.
781
782    * Curtis.N.Bingham <binge@aloft.att.com>
783
784    * Georges Brun-Cottan <bruncott@dormeur.inria.fr>
785
786    * Richard Caley <rjc@cogsci.ed.ac.uk>
787
788    * Richard Cognot <cognot@ensg.u-nancy.fr>
789
790    * Mark Daku <daku@nortel.ca>
791
792    * William G. Dubuque <wgd@martigny.ai.mit.edu>
793
794    * Eric Eide <eeide@cs.utah.edu>
795
796    * Alain Fauconnet <af@biomath.jussieu.fr>
797
798    * Chris Flatters <cflatter@nrao.edu>
799
800    * Evelyn Ginsparg <ginsparg@adra.com>
801
802    * Marty Hall <hall@aplcenmp.apl.jhu.edu>
803
804    * Darrell Kindred <dkindred@cmu.edu>
805
806    * David Moore <dmoore@ucsd.edu>
807
808    * Arup Mukherjee <arup+@cmu.edu>
809
810    * Juergen Nickelsen <nickel@prz.tu-berlin.de>
811
812    * Kevin R. Powell <powell@csl.ncsa.uiuc.edu>
813
814    * Justin Sheehy <dworkin@ccs.neu.edu>
815
816    * Stig <stig@hackvan.com>
817
818    * Aki Vehtari <Aki.Vehtari@hut.fi>
819
820 \1f
821 File: xemacs-faq.info,  Node: Q1.3.1,  Next: Q1.3.2,  Prev: Q1.2.3,  Up: Introduction
822
823 1.3: Internationalization
824 =========================
825
826 Q1.3.1: What is the status of internationalization support aka MULE (including Asian language support?
827 ------------------------------------------------------------------------------------------------------
828
829    Both the stable and development versions of XEmacs include
830 internationalization support (aka MULE).  MULE currently works on UNIX
831 and Linux systems; work for supporting MULE on Windows operating systems
832 is in progress.  Binaries compiled without MULE support run faster than
833 MULE capable XEmacsen.
834
835 \1f
836 File: xemacs-faq.info,  Node: Q1.3.2,  Next: Q1.3.3,  Prev: Q1.3.1,  Up: Introduction
837
838 Q1.3.2: How can I help with internationalization?
839 -------------------------------------------------
840
841    If you would like to help, you may want to join the
842 <xemacs-mule@xemacs.org> mailing list.  Especially needed are people
843 who speak/write languages other than English, who are willing to use
844 XEmacs/MULE regularly, and have some experience with Elisp.
845
846    *Note Q1.1.2::.
847
848 \1f
849 File: xemacs-faq.info,  Node: Q1.3.3,  Next: Q1.3.4,  Prev: Q1.3.2,  Up: Introduction
850
851 Q1.3.3: How do I type non-ASCII characters?
852 -------------------------------------------
853
854    See question 3.5.7 (*note Q3.5.7::) in part 3 of this FAQ.
855
856 \1f
857 File: xemacs-faq.info,  Node: Q1.3.4,  Next: Q1.3.5,  Prev: Q1.3.3,  Up: Introduction
858
859 Q1.3.4: Can XEmacs messages come out in a different language?
860 -------------------------------------------------------------
861
862    The message-catalog support has mostly been written but doesn't
863 currently work.  The first release of XEmacs 20 will _not_ support it.
864 However, menubar localization _does_ work.  To enable it, add to your
865 `Emacs' file entries like this:
866
867      Emacs*XlwMenu.resourceLabels:                   True
868      Emacs*XlwMenu.file.labelString:                 Fichier
869      Emacs*XlwMenu.openInOtherWindow.labelString:       In anderem Fenster oeffnen
870
871    The name of the resource is derived from the non-localized entry by
872 removing punctuation and capitalizing as above.
873
874 \1f
875 File: xemacs-faq.info,  Node: Q1.3.5,  Next: Q1.3.6,  Prev: Q1.3.4,  Up: Introduction
876
877 Q1.3.5: Please explain the various input methods in MULE/XEmacs
878 ---------------------------------------------------------------
879
880    MORIOKA Tomohiko <morioka@jaist.ac.jp> writes:
881
882      Original Mule supports the following input methods: Wnn4, Wnn6,
883      Canna, SJ3 and XIM. Interfaces for Wnn and SJ3 uses the `egg' user
884      interface. Interface for Canna does not use `egg'. I don't know
885      about XIM. It is to support ATOK, of course, it may work for
886      another servers.
887
888      Wnn supports Japanese, Chinese and Korean. It is made by OMRON and
889      Kyôto university. It is a powerful and complex system.  Wnn4 is
890      free and Wnn6 is not free.
891
892      Canna supports only Japanese. It is made by NEC. It is a simple and
893      powerful system. Canna uses only grammar (Wnn uses grammar and
894      probability between words), so I think Wnn is cleverer than Canna,
895      however Canna users made a good grammar and dictionary.  So for
896      standard modern Japanese, Canna seems cleverer than Wnn4. In
897      addition, the UNIX version of Canna is free (now there is a
898      Microsoft Windows version).
899
900      SJ3 supports only Japanese. It is made by Sony.  XIM supports was
901      made to use ATOK (a major input method in personal computer
902      world).  XIM is the standard for accessing input methods bundled
903      in Japanese versions of Solaris.  (XEmacs 20 will support XIM
904      input).
905
906      Egg consists of following parts:
907
908        1. Input character Translation System (ITS) layer.  It
909           translates ASCII inputs to Kana/PinYin/Hangul characters.
910
911        2. Kana/PinYin/Hangul to Kanji transfer layer.  It is interface
912           layer for network Kana-Kanji server (Wnn and Sj3).
913
914      These input methods are modal, namely there are mode, alphabet
915      mode and Kana-Kanji transfer mode.  However there are mode-less
916      input methods for Egg and Canna.  `Boiled-egg' is a mode-less
917      input method running on Egg.  For Canna, `canna.el' has a tiny
918      boiled-egg like command, `(canna-boil)', and there are some
919      boiled-egg like utilities.  In addition, it was planned to make an
920      abstraction for all transfer type input methods.  However authors
921      of input methods are busy, so maybe this plan is stopped.  Perhaps
922      after Mule merged GNU Emacs will be released, it will be continued.
923
924 \1f
925 File: xemacs-faq.info,  Node: Q1.3.6,  Next: Q1.3.7,  Prev: Q1.3.5,  Up: Introduction
926
927 Q1.3.6: How do I portably code for MULE/XEmacs?
928 -----------------------------------------------
929
930    MORIOKA Tomohiko <morioka@jaist.ac.jp> writes:
931
932      MULE and XEmacs are quite different. So the application
933      implementor must write separate code for these mule variants.
934
935      MULE and the next version of Emacs are similar but the symbols are
936      very different--requiring separate code as well.
937
938      Namely we must support 3 kinds of mule variants and 4 or 5 or 6
939      kinds of emacs variants... (;_;) I'm shocked, so I wrote a wrapper
940      package called `emu' to provide a common interface.
941
942      I have the following suggestions about dealing with mule variants:
943
944         * `(featurep 'mule)' `t' on all mule variants
945
946         * `(boundp 'MULE)' is `t' on only MULE.  Maybe the next version
947           of Emacs will not have this symbol.
948
949         * MULE has a variable `mule-version'.  Perhaps the next version
950           of Emacs will have this variable as well.
951
952      Following is a sample to distinguish mule variants:
953
954           (if (featurep 'mule)
955               (cond ((boundp 'MULE)
956                      ;; for original Mule
957                      )
958                     ((string-match "XEmacs" emacs-version)
959                      ;; for XEmacs with Mule
960                      )
961                     (t
962                      ;; for next version of Emacs
963                      ))
964             ;; for old emacs variants
965             )
966
967 \1f
968 File: xemacs-faq.info,  Node: Q1.3.7,  Next: Q1.4.1,  Prev: Q1.3.6,  Up: Introduction
969
970 Q1.3.7: How about Cyrillic Modes?
971 ---------------------------------
972
973    Ilya Zakharevich <ilya@math.ohio-state.edu> writes:
974
975      There is a cyrillic mode in the file `mysetup.zip' in
976      `ftp://ftp.math.ohio-state.edu/pub/users/ilya/emacs/'.  This is a
977      modification to Valery Alexeev's <ava@math.jhu.ed> `russian.el'
978      which can be obtained from
979
980    `http://ftpsearch.ntnu.no/?query=russian.el.Z'.
981
982    Dima Barsky <d.barsky@ee.surrey.ac.uk> writes:
983
984      There is another cyrillic mode for both GNU Emacs and XEmacs by
985      Dmitrii (Mitya) Manin <manin@camelot.mssm.edu> at
986      `http://kulichki-lat.rambler.ru/centrolit/manin/cyr.el'.
987
988    Rebecca Ore <rebecca.ore@op.net> writes:
989
990      The fullest resource I found on Russian language use (in and out of
991      XEmacs) is
992      `http://sunsite.oit.unc.edu/sergei/Software/Software.html'
993
994 \1f
995 File: xemacs-faq.info,  Node: Q1.4.1,  Next: Q1.4.2,  Prev: Q1.3.7,  Up: Introduction
996
997 1.4: Getting Started, Backing up & Recovery
998 ===========================================
999
1000 Q1.4.1: What is an `init.el' or `.emacs' and is there a sample one?
1001 -------------------------------------------------------------------
1002
1003    The `init.el' or `.emacs' file is used to customize XEmacs to your
1004 tastes.  Starting in 21.4, the preferred location for the init file is
1005 `~/.xemacs/init.el'; in previous versions, it was `~/.emacs'.  21.4
1006 still accepts the old location, but the first time you run it, it will
1007 ask to migrate your file to the new location.  If you answer yes, the
1008 file will be moved, and a "compatibility" `.emacs' file will be placed
1009 in the old location so that you can still run older versions of XEmacs,
1010 and versions of GNU Emacs, which expect the old location.  The `.emacs'
1011 file present is just a stub that loads the real file in
1012 `~/.xemacs/init.el'.
1013
1014    No two init files are alike, nor are they expected to be alike, but
1015 that's the point.  The XEmacs distribution contains an excellent starter
1016 example in the `etc/' directory called `sample.init.el' (starting in
1017 21.4) or `sample.emacs' in older versions.  Copy this file from there
1018 to `~/.xemacs/init.el' (starting in 21.4) or `~/.emacs' in older
1019 versions, where `~' means your home directory, of course.  Then edit it
1020 to suit.
1021
1022    You may bring the `sample.init.el' or `sample.emacs' file into an
1023 XEmacs buffer from the menubar. (The menu entry for it is always under
1024 the `Help' menu, but its location under that has changed in various
1025 versions.  Recently, look under the `Samples' submenu.)  To determine
1026 the location of the `etc/' directory type the command `C-h v
1027 data-directory <RET>'.
1028
1029 \1f
1030 File: xemacs-faq.info,  Node: Q1.4.2,  Next: Q1.4.3,  Prev: Q1.4.1,  Up: Introduction
1031
1032 Q1.4.2: Can I use the same `init.el'/`.emacs' with the other Emacs?
1033 -------------------------------------------------------------------
1034
1035    Yes.  The sample `init.el'/`.emacs' included in the XEmacs
1036 distribution will show you how to handle different versions and flavors
1037 of Emacs.
1038
1039 \1f
1040 File: xemacs-faq.info,  Node: Q1.4.3,  Next: Q1.4.4,  Prev: Q1.4.2,  Up: Introduction
1041
1042 Q1.4.3: Any good tutorials around?
1043 ----------------------------------
1044
1045    There's the XEmacs tutorial available from the Help Menu under
1046 `Basics->Tutorials', or by typing `C-h t'. To check whether it's
1047 available in a non-english language, type `C-u C-h t TAB', type the
1048 first letters of your preferred language, then type <RET>.
1049
1050 \1f
1051 File: xemacs-faq.info,  Node: Q1.4.4,  Next: Q1.4.5,  Prev: Q1.4.3,  Up: Introduction
1052
1053 Q1.4.4: May I see an example of a useful XEmacs Lisp function?
1054 --------------------------------------------------------------
1055
1056    The following function does a little bit of everything useful.  It
1057 does something with the prefix argument, it examines the text around the
1058 cursor, and it's interactive so it may be bound to a key.  It inserts
1059 copies of the current word the cursor is sitting on at the cursor.  If
1060 you give it a prefix argument: `C-u 3 M-x double-word' then it will
1061 insert 3 copies.
1062
1063      (defun double-word (count)
1064        "Insert a copy of the current word underneath the cursor"
1065        (interactive "*p")
1066        (let (here there string)
1067          (save-excursion
1068            (forward-word -1)
1069            (setq here (point))
1070            (forward-word 1)
1071            (setq there (point))
1072            (setq string (buffer-substring here there)))
1073          (while (>= count 1)
1074            (insert string)
1075            (decf count))))
1076
1077    The best way to see what is going on here is to let XEmacs tell you.
1078 Put the code into an XEmacs buffer, and do a `C-h f' with the cursor
1079 sitting just to the right of the function you want explained.  Eg.  move
1080 the cursor to the SPACE between `interactive' and `"*p"' and hit `C-h
1081 f' to see what the function `interactive' does.  Doing this will tell
1082 you that the `*' requires a writable buffer, and `p' converts the
1083 prefix argument to a number, and `interactive' allows you to execute
1084 the command with `M-x'.
1085
1086 \1f
1087 File: xemacs-faq.info,  Node: Q1.4.5,  Next: Q1.4.6,  Prev: Q1.4.4,  Up: Introduction
1088
1089 Q1.4.5: And how do I bind it to a key?
1090 --------------------------------------
1091
1092    To bind to a key do:
1093
1094      (global-set-key "\C-cd" 'double-word)
1095
1096    Or interactively, `M-x global-set-key' and follow the prompts.
1097
1098 \1f
1099 File: xemacs-faq.info,  Node: Q1.4.6,  Prev: Q1.4.5,  Up: Introduction
1100
1101 Q1.4.6: What's the difference between a macro and a function?
1102 -------------------------------------------------------------
1103
1104    Quoting from the Lisp Reference (a.k.a "Lispref") Manual:
1105
1106    "Macros" enable you to define new control constructs and other
1107 language features.  A macro is defined much like a function, but instead
1108 of telling how to compute a value, it tells how to compute another Lisp
1109 expression which will in turn compute the value.  We call this
1110 expression the "expansion" of the macro.
1111
1112    Macros can do this because they operate on the unevaluated
1113 expressions for the arguments, not on the argument values as functions
1114 do.  They can therefore construct an expansion containing these
1115 argument expressions or parts of them.
1116
1117    Do not confuse the two terms with "keyboard macros", which are
1118 another matter, entirely.  A keyboard macro is a key bound to several
1119 other keys.  Refer to manual for details.
1120
1121 \1f
1122 File: xemacs-faq.info,  Node: Installation,  Next: Customization,  Prev: Introduction,  Up: Top
1123
1124 2 Installation and Trouble Shooting
1125 ***********************************
1126
1127    This is part 2 of the XEmacs Frequently Asked Questions list.  This
1128 section is devoted to Installation, Maintenance and Trouble Shooting.
1129
1130 * Menu:
1131
1132 Installation:
1133 * Q2.0.1::      Running XEmacs without installing.
1134 * Q2.0.2::      XEmacs is too big.
1135 * Q2.0.3::      Compiling XEmacs with Netaudio.
1136 * Q2.0.4::      Problems with Linux and ncurses.
1137 * Q2.0.5::      Do I need X11 to run XEmacs?
1138 * Q2.0.6::      I'm having strange crashes.  What do I do?
1139 * Q2.0.7::      Libraries in non-standard locations.
1140 * Q2.0.8::      can't resolve symbol _h_errno
1141 * Q2.0.9::      Where do I find external libraries?
1142 * Q2.0.10::     After I run configure I find a coredump, is something wrong?
1143 * Q2.0.11::     XEmacs can't resolve host names.
1144 * Q2.0.12::     Why can't I strip XEmacs?
1145 * Q2.0.13::     I don't need no steenkin' packages.  Do I? (NEW)
1146 * Q2.0.14::     I don't want to install a million .els one at a time! (NEW)
1147
1148 Trouble Shooting:
1149 * Q2.1.1::      XEmacs just crashed on me!
1150 * Q2.1.2::      Cryptic Minibuffer messages.
1151 * Q2.1.3::      Translation Table Syntax messages at Startup.
1152 * Q2.1.4::      Startup warnings about deducing proper fonts?
1153 * Q2.1.5::      XEmacs cannot connect to my X Terminal.
1154 * Q2.1.6::      XEmacs just locked up my Linux X server.
1155 * Q2.1.7::      HP Alt key as Meta.
1156 * Q2.1.8::      got (wrong-type-argument color-instance-p nil)!
1157 * Q2.1.9::      XEmacs causes my OpenWindows 3.0 server to crash.
1158 * Q2.1.10::     Warnings from incorrect key modifiers.
1159 * Q2.1.11::     Can't instantiate image error... in toolbar
1160 * Q2.1.12::     Regular Expression Problems on DEC OSF1.
1161 * Q2.1.13::     HP/UX 10.10 and `create_process' failure
1162 * Q2.1.14::     C-g doesn't work for me.  Is it broken?
1163 * Q2.1.15::     How to debug an XEmacs problem with a debugger.
1164 * Q2.1.16::     XEmacs crashes in `strcat' on HP/UX 10.
1165 * Q2.1.17::     `Marker does not point anywhere'.
1166 * Q2.1.18::     [This question intentionally left blank]
1167 * Q2.1.19::     XEmacs does not follow the local timezone.
1168 * Q2.1.20::     `Symbol's function definition is void: hkey-help-show.'
1169 * Q2.1.21::     [This question intentionally left blank]
1170 * Q2.1.22::     XEmacs seems to take a really long time to do some things.
1171 * Q2.1.23::     Movemail on Linux does not work for XEmacs 19.15 and later.
1172 * Q2.1.24::     XEmacs won't start without network. (NEW)
1173 * Q2.1.25::     After upgrading, XEmacs won't do `foo' any more! (NEW)
1174
1175 \1f
1176 File: xemacs-faq.info,  Node: Q2.0.1,  Next: Q2.0.2,  Prev: Installation,  Up: Installation
1177
1178 2.0: Installation
1179 =================
1180
1181 Q2.0.1: Running XEmacs without installing
1182 -----------------------------------------
1183
1184    How can I just try XEmacs without installing it?
1185
1186    XEmacs will run in place without requiring installation and copying
1187 of the Lisp directories, and without having to specify a special
1188 build-time flag.  It's the copying of the Lisp directories that
1189 requires so much space.  XEmacs is largely written in Lisp.
1190
1191    A good method is to make a shell alias for xemacs:
1192
1193      alias xemacs=/i/xemacs-20.2/src/xemacs
1194
1195    (You will obviously use whatever directory you downloaded the source
1196 tree to instead of `/i/xemacs-20.2').
1197
1198    This will let you run XEmacs without massive copying.
1199
1200 \1f
1201 File: xemacs-faq.info,  Node: Q2.0.2,  Next: Q2.0.3,  Prev: Q2.0.1,  Up: Installation
1202
1203 Q2.0.2: XEmacs is too big
1204 -------------------------
1205
1206    The space required by the installation directories can be reduced
1207 dramatically if desired.  Gzip all the .el files.  Remove all the
1208 packages you'll never want to use.  Remove the TexInfo manuals.  Remove
1209 the Info (and use just hardcopy versions of the manual).  Remove most
1210 of the stuff in etc.  Remove or gzip all the source code.  Gzip or
1211 remove the C source code.  Configure it so that copies are not made of
1212 the support lisp.
1213
1214    These are all Emacs Lisp source code and bytecompiled object code.
1215 You may safely gzip everything named *.el here.  You may remove any
1216 package you don't use.  _Nothing bad will happen if you delete a package
1217 that you do not use_.  You must be sure you do not use it though, so be
1218 conservative at first.
1219
1220    Possible candidates for deletion include w3, games, hyperbole, mh-e,
1221 hm-html-menus, vm, viper, oobr, gnus, etc.  Ask yourself, _Do I ever
1222 want to use this package?_  If the answer is no, then it is a candidate
1223 for removal.
1224
1225    First, gzip all the .el files.  Then go about package by package and
1226 start gzipping the .elc files.  Then run XEmacs and do whatever it is
1227 you normally do.  If nothing bad happens, then delete the directory.  Be
1228 conservative about deleting directories, and it would be handy to have a
1229 backup around in case you get too zealous.
1230
1231    `prim', `modes', `packages', and `utils' are four directories you
1232 definitely do *not* want to delete, although certain packages can be
1233 removed from them if you do not use them.
1234
1235    Online texinfo sources in the `info' can either be compressed them
1236 or remove them.  In either case, `C-h i' (info mode) will no longer
1237 work.
1238