comparison man/xemacs-faq.texi @ 213:78f53ef88e17 r20-4b5

Import from CVS: tag r20-4b5
author cvs
date Mon, 13 Aug 2007 10:06:47 +0200
parents e45d5e7c476e
children 1f0dabaa0855
comparison
equal deleted inserted replaced
212:d8688acf4c5b 213:78f53ef88e17
6 @c %**end of header 6 @c %**end of header
7 7
8 @titlepage 8 @titlepage
9 @title XEmacs FAQ 9 @title XEmacs FAQ
10 @subtitle Frequently asked questions about XEmacs 10 @subtitle Frequently asked questions about XEmacs
11 @subtitle Last Modified: 1997-07-17 11 @subtitle Last Modified: 1997-11-10
12 @sp 1 12 @sp 1
13 @author Tony Rossini <arossini@@stat.sc.edu> 13 @author Tony Rossini <arossini@@stat.sc.edu>
14 @author Ben Wing <wing@@666.com> 14 @author Ben Wing <wing@@666.com>
15 @author Chuck Thompson <cthomp@@cs.uiuc.edu> 15 @author Chuck Thompson <cthomp@@cs.uiuc.edu>
16 @author Steve Baur <steve@@miranova.com> 16 @author Steve Baur <steve@@miranova.com>
418 track changes to GNU Emacs while also working to add new features. 418 track changes to GNU Emacs while also working to add new features.
419 419
420 @node Q1.0.2, Q1.0.3, Q1.0.1, Introduction 420 @node Q1.0.2, Q1.0.3, Q1.0.1, Introduction
421 @section What is the current version of XEmacs? 421 @section What is the current version of XEmacs?
422 422
423 The current stable version of XEmacs is 20.2, released in May, 1997. 423 There are currently two released versions of XEmacs:
424 The next feature release will XEmacs 20.3. 424
425 425 The current stable International version of XEmacs is 20.2, released in
426 XEmacs 19.15 was the last release of v19, released in March, 1997. 426 May, 1997. The next feature release will XEmacs 20.3.
427 427
428 To help users who are not yet ready to move to XEmacs 20, we run a 428 The current version of XEmacs without international language support is
429 patch-page with official bugfixes for 19.15 at: 429 XEmacs 19.16 and is the last release of v19. This version was released
430 in November, 1997.
431
432 We also run a patch-page with official bugfixes for 19.15 at:
430 433
431 @example 434 @example
432 <URL:http://www.xemacs.org/xemacs-19.15-patches/patch-page.html> 435 <URL:http://www.xemacs.org/xemacs-19.15-patches/patch-page.html>
433 @end example 436 @end example
434 437
435 The page is maintained by Vinnie Shelton @code{<acs@@acm.org>}. These 438 The page is maintained by Vinnie Shelton @code{<acs@@acm.org>}.
436 fixes will be integrated to a XEmacs and released as 19.16, which would
437 serve as stable XEmacs until 20.x settles completely.
438 439
439 @node Q1.0.3, Q1.0.4, Q1.0.2, Introduction 440 @node Q1.0.3, Q1.0.4, Q1.0.2, Introduction
440 @section Where can I find it? 441 @section Where can I find it?
441 442
442 The canonical source and binaries is found via anonymous FTP at: 443 The canonical source and binaries is found via anonymous FTP at:
629 No, and there is no news of anyone working on it. 630 No, and there is no news of anyone working on it.
630 631
631 @node Q1.0.14, Q1.1.1, Q1.0.13, Introduction 632 @node Q1.0.14, Q1.1.1, Q1.0.13, Introduction
632 @section Where can I obtain a printed copy of the XEmacs users manual? 633 @section Where can I obtain a printed copy of the XEmacs users manual?
633 634
634 InfoDock Associates, a firm specializing in Emacs-related support and 635 Altrasoft Associates, a firm specializing in Emacs-related support and
635 development, will be maintaining the XEmacs user manual. The firm plans 636 development, will be maintaining the XEmacs user manual. The firm plans
636 to begin publishing printed copies of the manual soon. 637 to begin publishing printed copies of the manual soon.
637 @c This used to say `March 1997'! 638 @c This used to say `March 1997'!
638 639
639 @example 640 @example
668 669
669 @node Q1.1.2, Q1.1.3, Q1.1.1, Introduction 670 @node Q1.1.2, Q1.1.3, Q1.1.1, Introduction
670 @section How do I become a Beta Tester? 671 @section How do I become a Beta Tester?
671 672
672 Send an email message to <xemacs-beta-request@@xemacs.org> with a 673 Send an email message to <xemacs-beta-request@@xemacs.org> with a
673 subject line of @samp{subscribe}. Fill out and return the questionnaire 674 subject line of @samp{subscribe}.
674 you get back, and you will receive the password to get at the current
675 beta.
676 675
677 Be prepared to get your hands dirty, as beta testers are expected to 676 Be prepared to get your hands dirty, as beta testers are expected to
678 identify problems as best they can. 677 identify problems as best they can.
679 678
680 @node Q1.1.3, Q1.2.1, Q1.1.2, Introduction 679 @node Q1.1.3, Q1.2.1, Q1.1.2, Introduction
711 710
712 @node Q1.2.1, Q1.2.2, Q1.1.3, Introduction 711 @node Q1.2.1, Q1.2.2, Q1.1.3, Introduction
713 @section Who wrote XEmacs? 712 @section Who wrote XEmacs?
714 713
715 XEmacs is the result of the time and effort of many people. The 714 XEmacs is the result of the time and effort of many people. The
716 developers responsible for the 19.15/20.x releases are: 715 developers responsible for the 19.16/20.x releases are:
717 716
718 @itemize @bullet 717 @itemize @bullet
719 @item Martin Buchholz <mrb@@eng.sun.com> 718 @item Martin Buchholz <mrb@@eng.sun.com>
720 719
721 @item Steve Baur <steve@@altair.xemacs.org> 720 @item Steve Baur <steve@@altair.xemacs.org>
721
722 @item Hrvoje Niksic <hniksic@@srce.hr>
722 @end itemize 723 @end itemize
723 724
724 The developers responsible for the 19.14 release are: 725 The developers responsible for the 19.14 release are:
725 726
726 @itemize @bullet 727 @itemize @bullet
802 @section What is the status of XEmacs v20? 803 @section What is the status of XEmacs v20?
803 804
804 XEmacs v20 is the version of XEmacs that includes MULE (Asian-language) 805 XEmacs v20 is the version of XEmacs that includes MULE (Asian-language)
805 support. XEmacs 20.0 was released in February 1997, followed by XEmacs 806 support. XEmacs 20.0 was released in February 1997, followed by XEmacs
806 20.2 in May. When compiled without MULE support 20.2 is currently very 807 20.2 in May. When compiled without MULE support 20.2 is currently very
807 similar to 19.15 (except for some changes to the byte-code format, some 808 similar to 19.16 (except for some changes to the byte-code format, some
808 new primitive types including @code{char}, @code{char-table}, and 809 new primitive types including @code{char}, @code{char-table}, and
809 @code{range-table}) and equally stable. 810 @code{range-table}) and equally stable.
810 811
811 @node Q1.3.2, Q1.3.3, Q1.3.1, Introduction 812 @node Q1.3.2, Q1.3.3, Q1.3.1, Introduction
812 @section What is the status of Asian-language support, aka MULE? 813 @section What is the status of Asian-language support, aka MULE?
951 952
952 @quotation 953 @quotation
953 There is a cyrillic mode in the file @file{mysetup.zip} in 954 There is a cyrillic mode in the file @file{mysetup.zip} in
954 <URL:ftp://ftp.math.ohio-state.edu/pub/users/ilya/emacs/>. This is a 955 <URL:ftp://ftp.math.ohio-state.edu/pub/users/ilya/emacs/>. This is a
955 modification to Valery Alexeev's <ava@@math.jhu.ed> @file{russian.el} 956 modification to Valery Alexeev's <ava@@math.jhu.ed> @file{russian.el}
956 which can be obtained from 957 which can be obtained from <URL:ftp://ftp.cis.ohio-state.edu/pub/gnu/emacs/elisp-archive/packages/russian.el.Z>.
957 <URL:ftp://ftp.cis.ohio-state.edu/pub/gnu/emacs/elisp-archive/packages/russian.el.Z>.
958 @end quotation 958 @end quotation
959 959
960 Dima Barsky <d.barsky@@ee.surrey.ac.uk> writes: 960 Dima Barsky <d.barsky@@ee.surrey.ac.uk> writes:
961 961
962 @quotation 962 @quotation
1071 1071
1072 Do not confuse the two terms with @dfn{keyboard macros}, which are 1072 Do not confuse the two terms with @dfn{keyboard macros}, which are
1073 another matter, entirely. A keyboard macro is a key bound to several 1073 another matter, entirely. A keyboard macro is a key bound to several
1074 other keys. Refer to manual for details. 1074 other keys. Refer to manual for details.
1075 1075
1076 @node Q1.4.7, , Q1.4.6, Introduction 1076 @node Q1.4.7, , Q1.4.6, Introduction
1077 @section How come options saved with 19.13 don't work with 19.14 or later? 1077 @section How come options saved with 19.13 don't work with 19.14 or later?
1078 1078
1079 There's a problem with options of the form: 1079 There's a problem with options of the form:
1080 1080
1081 @lisp 1081 @lisp
1605 1605
1606 @item 1606 @item
1607 cp src/xemacs /usr/local/bin/xemacs 1607 cp src/xemacs /usr/local/bin/xemacs
1608 1608
1609 @item 1609 @item
1610 cp lib-src/DOC-19.15-XEmacs /usr/local/lib/xemacs-19.15/i586-unknown-linuxaout 1610 cp lib-src/DOC-19.16-XEmacs /usr/local/lib/xemacs-19.16/i586-unknown-linuxaout
1611 @end enumerate 1611 @end enumerate
1612 @end quotation 1612 @end quotation
1613 1613
1614 @node Q2.0.13, Q2.0.14, Q2.0.12, Installation 1614 @node Q2.0.13, Q2.0.14, Q2.0.12, Installation
1615 @section Problems linking with Gcc on Solaris 1615 @section Problems linking with Gcc on Solaris
1631 @end quotation 1631 @end quotation
1632 1632
1633 @node Q2.0.14, Q2.1.1, Q2.0.13, Installation 1633 @node Q2.0.14, Q2.1.1, Q2.0.13, Installation
1634 @section Make on HP/UX 9 fails after linking temacs 1634 @section Make on HP/UX 9 fails after linking temacs
1635 1635
1636 Problem when building xemacs-19.15 on hpux 9: 1636 Problem when building xemacs-19.16 on hpux 9:
1637 1637
1638 Richard Cognot <cognot@@ensg.u-nancy.fr> writes: 1638 Richard Cognot <cognot@@ensg.u-nancy.fr> writes:
1639 1639
1640 @quotation 1640 @quotation
1641 make on hpux fails after linking temacs with a message: 1641 make on hpux fails after linking temacs with a message:
1767 hardcoded at compile time so if the system the binary was built on puts 1767 hardcoded at compile time so if the system the binary was built on puts
1768 it a different place than your system does, you have problems. To fix, 1768 it a different place than your system does, you have problems. To fix,
1769 set the environment variable @var{XKEYSYMDB} to the location of the 1769 set the environment variable @var{XKEYSYMDB} to the location of the
1770 @file{XKeysymDB} file on your system or to the location of the one 1770 @file{XKeysymDB} file on your system or to the location of the one
1771 included with XEmacs which should be at 1771 included with XEmacs which should be at
1772 @file{<xemacs_root_directory>/lib/xemacs-19.15/etc/XKeysymDB}. 1772 @file{<xemacs_root_directory>/lib/xemacs-19.16/etc/XKeysymDB}.
1773 1773
1774 @item 1774 @item
1775 The binary is finding the XKeysymDB but it is out-of-date on your system 1775 The binary is finding the XKeysymDB but it is out-of-date on your system
1776 and does not contain the necessary lines. Either ask your system 1776 and does not contain the necessary lines. Either ask your system
1777 administrator to replace it with the one which comes with XEmacs (which 1777 administrator to replace it with the one which comes with XEmacs (which
4005 with all major XEmacs packages like Gnus (all flavors), VM, MH-E, and 4005 with all major XEmacs packages like Gnus (all flavors), VM, MH-E, and
4006 mailcrypt. It provides totally transparent and trouble-free MIME 4006 mailcrypt. It provides totally transparent and trouble-free MIME
4007 support. When appropriate a message will be decoded in place in an 4007 support. When appropriate a message will be decoded in place in an
4008 XEmacs buffer. 4008 XEmacs buffer.
4009 4009
4010 TM now comes as a package with XEmacs 19.15 and XEmacs 20.0. 4010 TM now comes as a package with XEmacs 19.16 and XEmacs 20.2.
4011 4011
4012 TM was written by MORIOKA Tomohiko <morioka@@jaist.ac.jp> and KOBAYASHI 4012 TM was written by MORIOKA Tomohiko <morioka@@jaist.ac.jp> and KOBAYASHI
4013 Shuhei <shuhei-k@@jaist.ac.jp>. It is based on the work of UMEDA 4013 Shuhei <shuhei-k@@jaist.ac.jp>. It is based on the work of UMEDA
4014 Masanobu <umerin@@mse.kyutech.ac.jp>, the original writer of GNUS. 4014 Masanobu <umerin@@mse.kyutech.ac.jp>, the original writer of GNUS.
4015 4015
4298 4298
4299 @node Q4.7.1, Q4.7.2, Q4.6.1, Subsystems 4299 @node Q4.7.1, Q4.7.2, Q4.6.1, Subsystems
4300 @section What is AUC TeX? Where do you get it? 4300 @section What is AUC TeX? Where do you get it?
4301 4301
4302 AUC TeX is a package written by Per Abrahamsen <abraham@@dina.kvl.dk>. 4302 AUC TeX is a package written by Per Abrahamsen <abraham@@dina.kvl.dk>.
4303 Starting with XEmacs 19.15, AUC TeX is bundled with XEmacs. The 4303 Starting with XEmacs 19.16, AUC TeX is bundled with XEmacs. The
4304 following information is from the @file{README} and website. 4304 following information is from the @file{README} and website.
4305 4305
4306 AUC TeX is an extensible package that supports writing and formatting 4306 AUC TeX is an extensible package that supports writing and formatting
4307 TeX files for most variants of GNU Emacs. Many different macro packages 4307 TeX files for most variants of GNU Emacs. Many different macro packages
4308 are supported, including AMS TeX, LaTeX, and TeXinfo. 4308 are supported, including AMS TeX, LaTeX, and TeXinfo.
4436 * Q5.1.1:: The difference in key sequences between XEmacs and GNU Emacs? 4436 * Q5.1.1:: The difference in key sequences between XEmacs and GNU Emacs?
4437 * Q5.1.2:: Can I generate "fake" keyboard events? 4437 * Q5.1.2:: Can I generate "fake" keyboard events?
4438 * Q5.1.3:: Could you explain @code{read-kbd-macro} in more detail? 4438 * Q5.1.3:: Could you explain @code{read-kbd-macro} in more detail?
4439 * Q5.1.4:: What is the performance hit of @code{let}? 4439 * Q5.1.4:: What is the performance hit of @code{let}?
4440 * Q5.1.5:: What is the recommended use of @code{setq}? 4440 * Q5.1.5:: What is the recommended use of @code{setq}?
4441 * Q5.1.6:: What is the typical misuse of @code{setq} ? 4441 * Q5.1.6:: What is the typical misuse of @code{setq}?
4442 * Q5.1.7:: I like the the @code{do} form of cl, does it slow things down? 4442 * Q5.1.7:: I like the the @code{do} form of cl, does it slow things down?
4443 * Q5.1.8:: I like recursion, does it slow things down? 4443 * Q5.1.8:: I like recursion, does it slow things down?
4444 * Q5.1.9:: How do I put a glyph as annotation in a buffer? 4444 * Q5.1.9:: How do I put a glyph as annotation in a buffer?
4445 * Q5.1.10:: @code{map-extents} won't traverse all of my extents!
4445 4446
4446 Sound: 4447 Sound:
4447 * Q5.2.1:: How do I turn off the sound? 4448 * Q5.2.1:: How do I turn off the sound?
4448 * Q5.2.2:: How do I get funky sounds instead of a boring beep? 4449 * Q5.2.2:: How do I get funky sounds instead of a boring beep?
4449 * Q5.2.3:: What's NAS, how do I get it? 4450 * Q5.2.3:: What's NAS, how do I get it?
5089 fact that it is an interpreter. 5090 fact that it is an interpreter.
5090 5091
5091 Please try not to make your code much uglier to gain a very small speed 5092 Please try not to make your code much uglier to gain a very small speed
5092 gain. It's not usually worth it. 5093 gain. It's not usually worth it.
5093 5094
5094 @node Q5.1.9, Q5.2.1, Q5.1.8, Miscellaneous 5095 @node Q5.1.9, Q5.1.10, Q5.1.8, Miscellaneous
5095 @section How do I put a glyph as annotation in a buffer? 5096 @section How do I put a glyph as annotation in a buffer?
5096 5097
5097 Here is a solution that will insert the glyph annotation at the 5098 Here is a solution that will insert the glyph annotation at the
5098 beginning of buffer: 5099 beginning of buffer:
5099 5100
5112 5113
5113 You can turn this to a function (that optionally prompts you for a file 5114 You can turn this to a function (that optionally prompts you for a file
5114 name), and inserts the glyph at @code{(point)} instead of 5115 name), and inserts the glyph at @code{(point)} instead of
5115 @code{(point-min)}. 5116 @code{(point-min)}.
5116 5117
5117 @node Q5.2.1, Q5.2.2, Q5.1.9, Miscellaneous 5118 @node Q5.1.10, Q5.2.1, Q5.1.9, Miscellaneous
5119 @section @code{map-extents} won't traverse all of my extents!
5120
5121 I tried to use @code{map-extents} to do an operation on all the extents
5122 in a region. However, it seems to quit after processing a random number
5123 of extents. Is it buggy?
5124
5125 No. The documentation of @code{map-extents} states that it will iterate
5126 across the extents as long as @var{function} returns @code{nil}.
5127 Unexperienced programmers often forget to return @code{nil} explicitly,
5128 which results in buggy code. For instance, the following code is
5129 supposed to delete all the extents in a buffer, and issue as many
5130 @samp{fubar!} messages.
5131
5132 @lisp
5133 (map-extents (lambda (ext ignore)
5134 (delete-extent ext)
5135 (message "fubar!")))
5136 @end lisp
5137
5138 Instead, it will delete only the first extent, and stop right there --
5139 because @code{message} will return a non-nil value. The correct code
5140 is:
5141
5142 @lisp
5143 (map-extents (lambda (ext ignore)
5144 (delete-extent ext)
5145 (message "fubar!")
5146 nil))
5147 @end lisp
5148
5149 @node Q5.2.1, Q5.2.2, Q5.1.10, Miscellaneous
5118 @section How do I turn off the sound? 5150 @section How do I turn off the sound?
5119 5151
5120 Add the following line to your @file{.emacs}: 5152 Add the following line to your @file{.emacs}:
5121 5153
5122 @lisp 5154 @lisp