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