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