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