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