Mercurial > hg > xemacs-beta
diff man/xemacs-faq.texi @ 274:ca9a9ec9c1c1 r21-0b35
Import from CVS: tag r21-0b35
author | cvs |
---|---|
date | Mon, 13 Aug 2007 10:29:42 +0200 |
parents | c5d627a313b1 |
children | 6330739388db |
line wrap: on
line diff
--- a/man/xemacs-faq.texi Mon Aug 13 10:28:54 2007 +0200 +++ b/man/xemacs-faq.texi Mon Aug 13 10:29:42 2007 +0200 @@ -4,17 +4,18 @@ @settitle Frequently asked questions about XEmacs @setchapternewpage off @c %**end of header - +@finalout @titlepage @title XEmacs FAQ @subtitle Frequently asked questions about XEmacs -@subtitle Last Modified: 1997-12-04 02:05:05 EET +@subtitle Last Modified: $Date: 1998/04/07 05:39:30 $ @sp 1 @author Tony Rossini <arossini@@stat.sc.edu> @author Ben Wing <wing@@666.com> @author Chuck Thompson <cthomp@@xemacs.org> @author Steve Baur <steve@@xemacs.org> @author Andreas Kaempf <andreas@@sccon.com> +@author Christian Nyb@o{} <chr@@mediascience.no> @page @end titlepage @@ -32,10 +33,14 @@ FITNESS FOR A PARTICULAR PURPOSE. If you have a Web browser, the official hypertext version is at -<URL:http://www.sccon.com/~andreas/xemacs-faq.html> and also at -<URL:http://www.xemacs.org/faq/xemacs-faq.html>. This version is much -nicer than the unofficial hypertext versions that are archived at -Utrecht, Oxford, Smart Pages, and other FAQ archives. +@iftex +@* +@end iftex +@uref{http://www.xemacs.org/faq/xemacs-faq.html}. + +This version is somewhat nicer than the unofficial hypertext versions +that are archived at Utrecht, Oxford, Smart Pages, and other FAQ +archives. @menu * Introduction:: Introduction, Policy, Credits. @@ -56,10 +61,10 @@ * Q1.0.3:: Where can I find it? * Q1.0.4:: Why Another Version of Emacs? * Q1.0.5:: Why Haven't XEmacs and GNU Emacs Merged? -* Q1.0.6:: Where can I get help? +* Q1.0.6:: Where can I get help? * Q1.0.7:: Where is the mailing list archived? * Q1.0.8:: How do you pronounce XEmacs? -* Q1.0.9:: What does XEmacs look like? +* Q1.0.9:: What does XEmacs look like? * Q1.0.10:: Is there a port of XEmacs to Microsoft ('95 or NT)? * Q1.0.11:: Is there a port of XEmacs to the Macintosh? * Q1.0.12:: Is there a port of XEmacs to NextStep? @@ -73,17 +78,17 @@ Credits: * Q1.2.1:: Who wrote XEmacs? -* Q1.2.2:: Who contributed to this version of the FAQ? -* Q1.2.3:: Who contributed to the FAQ in the past? +* Q1.2.2:: Who contributed to this version of the FAQ? +* Q1.2.3:: Who contributed to the FAQ in the past? Internationalization: -* Q1.3.1:: What is the status of XEmacs v20? +* Q1.3.1:: What is the status of XEmacs v20? * Q1.3.2:: What is the status of Asian-language support, aka @var{mule}? * Q1.3.3:: How do I type non-ASCII characters? * Q1.3.4:: Can XEmacs messages come out in a different language? * Q1.3.5:: Please explain the various input methods in MULE/XEmacs 20.0 * Q1.3.6:: How do I portably code for MULE/XEmacs 20.0? -* Q1.3.7:: How about Cyrillic Modes? +* Q1.3.7:: How about Cyrillic Modes? Getting Started: * Q1.4.1:: What is a @file{.emacs} and is there a sample one? @@ -96,20 +101,20 @@ Installation and Trouble Shooting -* Q2.0.1:: Running XEmacs without installing. -* Q2.0.2:: XEmacs is too big. +* Q2.0.1:: Running XEmacs without installing. +* Q2.0.2:: XEmacs is too big. * Q2.0.3:: Compiling XEmacs with Netaudio. * Q2.0.4:: Problems with Linux and ncurses. * Q2.0.5:: Do I need X11 to run XEmacs? * Q2.0.6:: I'm having strange crashes. What do I do? * Q2.0.7:: Libraries in non-standard locations. * Q2.0.8:: can't resolve symbol _h_errno -* Q2.0.9:: Where do I find external libraries? +* Q2.0.9:: Where do I find external libraries? * Q2.0.10:: After I run configure I find a coredump, is something wrong? * Q2.0.11:: XEmacs can't resolve host names. -* Q2.0.12:: Why can't I strip XEmacs? +* Q2.0.12:: Why can't I strip XEmacs? * Q2.0.13:: Can't link XEmacs on Solaris with Gcc. -* Q2.0.14:: Make on HP/UX 9 fails after linking temacs +* Q2.0.14:: Make on HP/UX 9 fails after linking temacs Trouble Shooting: * Q2.1.1:: XEmacs just crashed on me! @@ -138,13 +143,13 @@ Customization and Options -* Q3.0.1:: What version of Emacs am I running? +* Q3.0.1:: What version of Emacs am I running? * Q3.0.2:: How do I evaluate Elisp expressions? * Q3.0.3:: @code{(setq tab-width 6)} behaves oddly. * Q3.0.4:: How can I add directories to the @code{load-path}? * Q3.0.5:: How to check if a lisp function is defined? * Q3.0.6:: Can I force the output of @code{(face-list)} to a buffer? -* Q3.0.7:: Font selections don't get saved after @code{Save Options}. +* Q3.0.7:: Font selections don't get saved after @code{Save Options}. * Q3.0.8:: How do I make a single minibuffer frame? * Q3.0.9:: What is @code{Customize}? @@ -156,13 +161,13 @@ * Q3.1.5:: How can I get the icon to just say @samp{XEmacs}? * Q3.1.6:: How can I have the window title area display the full path? * Q3.1.7:: @samp{xemacs -name junk} doesn't work? -* Q3.1.8:: @samp{-iconic} doesn't work. +* Q3.1.8:: @samp{-iconic} it doesn't work. Textual Fonts & Colors: * Q3.2.1:: How can I set color options from @file{.emacs}? * Q3.2.2:: How do I set the text, menu and modeline fonts? * Q3.2.3:: How can I set the colors when highlighting a region? -* Q3.2.4:: How can I limit color map usage? +* Q3.2.4:: How can I limit color map usage? * Q3.2.5:: My tty supports color, but XEmacs doesn't use them. The Modeline: @@ -173,7 +178,7 @@ * Q3.3.5:: How can one change the modeline color based on the mode used? 3.4 Multiple Device Support: -* Q3.4.1:: How do I open a frame on another screen of my multi-headed display? +* Q3.4.1:: How do I open a frame on another screen of my multi-headed display? * Q3.4.2:: Can I really connect to a running XEmacs after calling up over a modem? How? 3.5 The Keyboard: @@ -182,7 +187,7 @@ * Q3.5.3:: How do I bind C-. and C-; to scroll one line up and down? * Q3.5.4:: Globally binding @kbd{Delete}? * Q3.5.5:: Scrolling one line at a time. -* Q3.5.6:: How to map @kbd{Help} key alone on Sun type4 keyboard? +* Q3.5.6:: How to map @kbd{Help} key alone on Sun type4 keyboard? * Q3.5.7:: How can you type in special characters in XEmacs? * Q3.5.8:: Why does @code{(global-set-key [delete-forward] 'delete-char)} complain? * Q3.5.9:: How do I make the Delete key delete forward? @@ -217,7 +222,7 @@ * Q3.9.4:: How can I get automatic horizontal scrolling? Text Selections: -* Q3.10.1:: How can I turn off or change highlighted selections? +* Q3.10.1:: How can I turn off or change highlighted selections? * Q3.10.2:: How do I get that typing on an active region removes it? * Q3.10.3:: Can I turn off the highlight during isearch? * Q3.10.4:: How do I turn off highlighting after @kbd{C-x C-p} (mark-page)? @@ -244,7 +249,7 @@ * Q4.1.3:: Is it true that W3 supports style sheets and tables? Reading Netnews and Mail with Gnus: -* Q4.2.1:: GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus, Quassia Gnus, argh! +* Q4.2.1:: GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus, Quassia Gnus, argh! * Q4.2.2:: [This question intentionally left blank] * Q4.2.3:: How do I make Gnus stay within a single frame? * Q4.2.4:: How do I customize the From: line? @@ -257,7 +262,7 @@ * Q4.3.5:: Where do I find pstogif (required by tm)? Sparcworks, EOS, and WorkShop: -* Q4.4.1:: What is SPARCworks, EOS, and WorkShop +* Q4.4.1:: What is SPARCworks, EOS, and WorkShop Energize: * Q4.5.1:: What is/was Energize? @@ -283,8 +288,8 @@ * Q5.0.7:: Telnet from shell filters too much. * Q5.0.8:: Why does edt emulation not work? * Q5.0.9:: How can I emulate VI and use it as my default mode? -* Q5.0.10:: [This question intentionally left blank] -* Q5.0.11:: Filladapt doesn't work in 19.15? +* Q5.0.10:: [This question intentionally left blank] +* Q5.0.11:: Filladapt doesn't work in 19.15? * Q5.0.12:: How do I disable gnuserv from opening a new frame? * Q5.0.13:: How do I start gnuserv so that each subsequent XEmacs is a client? * Q5.0.14:: Strange things are happening in Shell Mode. @@ -293,6 +298,7 @@ * Q5.0.17:: How can I get two instances of info? * Q5.0.18:: I upgraded to XEmacs 19.14 and gnuserv stopped working * Q5.0.19:: Is there something better than LaTeX mode? +* Q5.0.20:: Is there a way to start a new XEmacs if there's no gnuserv running, and otherwise use gnuclient? Emacs Lisp Programming Techniques: * Q5.1.1:: The difference in key sequences between XEmacs and GNU Emacs? @@ -329,39 +335,41 @@ * Q6.0.1:: What is new in 20.2? * Q6.0.2:: What is new in 20.3? -* Q6.0.3:: Procedural changes in XEmacs development. +* Q6.0.3:: What is new in 20.4? +* Q6.0.4:: Procedural changes in XEmacs development. @end detailmenu @end menu @node Introduction, Installation, Top, Top -@chapter Introduction, Policy, Credits - -Learning XEmacs is a lifelong activity. I've been using Emacs for -over a decade now, and I'm still discovering new features. Therefore -this document cannot be complete. Instead it is aimed at the person -who is either considering XEmacs for their own use, or has just -obtained it and is wondering what to do next. It is also useful as a -reference to available resources. - -The previous maintainer of the FAQ was Anthony Rossini -<rossini@@stat.sc.edu>, who started it, after getting tired of hearing -JWZ complain about repeatedly having to answer questions. Ben Wing -<ben@@666.com> and Chuck Thompson <cthomp@@xemacs.org>, the principal -authors of XEmacs, then took over and Ben did a massive update -reorganizing the whole thing. At which point Anthony took back over, -but then had to give it up again. Some of the other contributors to -this FAQ are listed later in this document. +@unnumbered 1 Introduction, Policy, Credits + +Learning XEmacs is a lifelong activity. Even people who have used Emacs +for years keep discovering new features. Therefore this document cannot +be complete. Instead it is aimed at the person who is either +considering XEmacs for their own use, or has just obtained it and is +wondering what to do next. It is also useful as a reference to +available resources. + +The previous maintainer of the FAQ was @email{rossini@@stat.sc.edu, +Anthony Rossini}, who started it, after getting tired of hearing JWZ +complain about repeatedly having to answer questions. +@email{ben@@666.com, Ben Wing} and @email{cthomp@@xemacs.org, Chuck +Thompson}, the principal authors of XEmacs, then took over and Ben did +a massive update reorganizing the whole thing. At which point Anthony +took back over, but then had to give it up again. Some of the other +contributors to this FAQ are listed later in this document. The previous version was converted to hypertext format, and edited by -Steven L. Baur <steve@@altair.xemacs.org>. It was converted back to -texinfo by Hrvoje Niksic <hniksic@@srce.hr>. - -Since Steve Baur is so busy putting out multiple versions of XEmacs I -have taken on the task of maintaining the FAQ. I use XEmacs on a daily -basis and I wanted to give something back to the community that has made -XEmacs possible. If you notice any errors or items which should be -added or amended to this FAQ please send email to Andreas Kaempf -<andreas@@sccon.com>. Include @samp{XEmacs FAQ} on the Subject: line. +@email{steve@@altair.xemacs.org, Steven L. Baur}. It was converted back to +texinfo by @email{hniksic@@srce.hr, Hrvoje Niksic}. + +The FAQ was then maintained by @email{andreas@@sccon.com, Andreas +Kaempf}, who passed it on to @email{chr@@mediascience.no, Christian +Nyb@o{}}, the current FAQ maintainer. + +If you notice any errors or items which should be added or amended to +this FAQ please send email to @email{chr@@mediascience.no, Christian +Nyb@o{}}. Include @samp{XEmacs FAQ} on the Subject: line. @menu Introduction: @@ -370,10 +378,10 @@ * Q1.0.3:: Where can I find it? * Q1.0.4:: Why Another Version of Emacs? * Q1.0.5:: Why Haven't XEmacs and GNU Emacs Merged? -* Q1.0.6:: Where can I get help? +* Q1.0.6:: Where can I get help? * Q1.0.7:: Where is the mailing list archived? * Q1.0.8:: How do you pronounce XEmacs? -* Q1.0.9:: What does XEmacs look like? +* Q1.0.9:: What does XEmacs look like? * Q1.0.10:: Is there a port of XEmacs to Microsoft ('95 or NT)? * Q1.0.11:: Is there a port of XEmacs to the Macintosh? * Q1.0.12:: Is there a port of XEmacs to NextStep? @@ -387,17 +395,17 @@ Credits: * Q1.2.1:: Who wrote XEmacs? -* Q1.2.2:: Who contributed to this version of the FAQ? -* Q1.2.3:: Who contributed to the FAQ in the past? +* Q1.2.2:: Who contributed to this version of the FAQ? +* Q1.2.3:: Who contributed to the FAQ in the past? Internationalization: -* Q1.3.1:: What is the status of XEmacs v20? +* Q1.3.1:: What is the status of XEmacs v20? * Q1.3.2:: What is the status of Asian-language support, aka @var{mule}? * Q1.3.3:: How do I type non-ASCII characters? * Q1.3.4:: Can XEmacs messages come out in a different language? * Q1.3.5:: Please explain the various input methods in MULE/XEmacs 20.0 * Q1.3.6:: How do I portably code for MULE/XEmacs 20.0? -* Q1.3.7:: How about Cyrillic Modes? +* Q1.3.7:: How about Cyrillic Modes? Getting Started: * Q1.4.1:: What is a @file{.emacs} and is there a sample one? @@ -410,7 +418,9 @@ @end menu @node Q1.0.1, Q1.0.2, Introduction, Introduction -@section What is XEmacs? +@unnumberedsec 1.0: Introduction +@unnumberedsubsec Q1.0.1: What is XEmacs? + An alternative to GNU Emacs, originally based on an early alpha version of FSF's version 19, and has diverged quite a bit since then. XEmacs @@ -419,32 +429,30 @@ track changes to GNU Emacs while also working to add new features. @node Q1.0.2, Q1.0.3, Q1.0.1, Introduction -@section What is the current version of XEmacs? - -The current stable version of XEmacs is 20.3, released in November, -1997. - -The next feature release will be XEmacs 20.4. +@unnumberedsubsec Q1.0.2: What is the current version of XEmacs? + +XEmacs 20.4 is a minor upgrade from 20.3, containing many bugfixes. It +was released in February 1998. XEmacs 19.16 was the last release of v19, released in November, 1997, which was also the last version without international language support. @node Q1.0.3, Q1.0.4, Q1.0.2, Introduction -@section Where can I find it? +@unnumberedsubsec Q1.0.3: Where can I find it? The canonical source and binaries is found via anonymous FTP at: @example -<URL:ftp.xemacs.org:/pub/xemacs/> +@uref{ftp://ftp.xemacs.org/pub/xemacs/} @end example @node Q1.0.4, Q1.0.5, Q1.0.3, Introduction -@section Why Another Version of Emacs? +@unnumberedsubsec Q1.0.4: Why Another Version of Emacs? For a detailed description of the differences between GNU Emacs and XEmacs and a detailed history of XEmacs, check out the @example -<URL:http://www.xemacs.org/NEWS.html> +@uref{http://www.xemacs.org/NEWS.html, NEWS file} @end example However, here is a list of some of the reasons why we think you might @@ -511,7 +519,7 @@ @end itemize @node Q1.0.5, Q1.0.6, Q1.0.4, Introduction -@section Why Haven't XEmacs and GNU Emacs Merged? +@unnumberedsubsec Q1.0.5: Why Haven't XEmacs and GNU Emacs Merged? There are currently irreconcilable differences in the views about technical, programming, design and organizational matters between RMS @@ -519,12 +527,12 @@ take place in the short-term future. If you have a comment to add regarding the merge, it is a good idea to -avoid posting to the newsgroups, because of the very heated flamewars -that often result. Mail your questions to <xemacs-beta@@xemacs.org> and -<bug-gnu-emacs@@prep.ai.mit.edu>. +avoid posting to the newsgroups, because of the very heated flamewars +that often result. Mail your questions to @email{xemacs-beta@@xemacs.org} and +@email{bug-gnu-emacs@@prep.ai.mit.edu}. @node Q1.0.6, Q1.0.7, Q1.0.5, Introduction -@section Where can I get help? +@unnumberedsubsec Q1.0.6: Where can I get help? Probably the easiest way, if everything is installed, is to use info, by pressing @kbd{C-h i}, or selecting @code{Emacs Info} from the Help Menu. @@ -533,7 +541,7 @@ Try reading this FAQ, examining the regular GNU Emacs FAQ (which can be found with the Emacs 19 distribution) as well as at -<URL:http://www.eecs.nwu.edu/emacs/faq/> and reading the Usenet group +@uref{http://www.eecs.nwu.edu/emacs/faq/} and reading the Usenet group comp.emacs.xemacs. If that does not help, try posting your question to comp.emacs.xemacs. @@ -541,8 +549,8 @@ If you cannot post or read Usenet news, there is a corresponding mailing list which is available. It can be subscribed to by sending a message -with a subject of @samp{subscribe} to <xemacs-request@@xemacs.org> -for subscription information and <xemacs@@xemacs.org> to send messages +with a subject of @samp{subscribe} to @email{xemacs-request@@xemacs.org} +for subscription information and @email{xemacs@@xemacs.org} to send messages to the list. To cancel a subscription, you @strong{must} use the xemacs-request @@ -550,79 +558,85 @@ removed. @node Q1.0.7, Q1.0.8, Q1.0.6, Introduction -@section Where is the mailing list archived? +@unnumberedsubsec Q1.0.7: Where is the mailing list archived? The mailing list was archived in the directory @example -<URL:ftp://ftp.xemacs.org:/pub/mlists/>. +@uref{ftp://ftp.xemacs.org/pub/mlists/}. @end example However, this archive is out of date. The current mailing list server supports an @code{archive} feature, which may be utilized. @node Q1.0.8, Q1.0.9, Q1.0.7, Introduction -@section How do you pronounce XEmacs? +@unnumberedsubsec Q1.0.8: How do you pronounce XEmacs? I pronounce it @samp{Eks eemax}. @node Q1.0.9, Q1.0.10, Q1.0.8, Introduction -@section What does XEmacs look like? +@unnumberedsubsec Q1.0.9: What does XEmacs look like? Screen snapshots are available in the WWW version of the FAQ. @example -<URL:http://www.xemacs.org/faq/xemacs-faq.html> +@uref{http://www.xemacs.org/faq/xemacs-faq.html} @end example @node Q1.0.10, Q1.0.11, Q1.0.9, Introduction -@section Is there a port of XEmacs to Microsoft ('95 or NT)? - -Thanks to efforts of many people, coordinated by David Hobley -<davidh@@wr.com.au> and Marc Paquette <marcpa@@cam.org>, beta versions -of XEmacs now run on 32-bit Windows platforms (NT and 95). The current -betas require having an X server to run XEmacs; however, a native NT/95 -port is in alpha, thanks to Jonathan Harris <jhar@@tardis.ed.ac.uk>. +@unnumberedsubsec Q1.0.10: Is there a port of XEmacs to Microsoft ('95 or NT)? + +Thanks to efforts of many people, coordinated by +@email{davidh@@wr.com.au, David Hobley} and @email{marcpa@@cam.org, Marc +Paquette}, beta versions of XEmacs now run on 32-bit Windows platforms +(NT and 95). The current betas require having an X server to run +XEmacs; however, a native NT/95 port is in alpha, thanks to +@email{jhar@@tardis.ed.ac.uk, Jonathan Harris}. The NT development is now coordinated by a mailing list at -<xemacs-nt@@xemacs.org>. If you are willing to contribute or want to -follow the progress, mail to <xemacs-nt-request@@xemacs.org> to -subscribe. +@email{xemacs-nt@@xemacs.org}. + +If you are willing to contribute or want to follow the progress, mail to +@iftex +@* +@end iftex +@email{xemacs-nt-request@@xemacs.org} to subscribe. Furthermore, Altrasoft is seeking corporate and government sponsors to help fund a fully native port of XEmacs to Windows 95 and NT using full-time, senior-level staff working under a professionally managed -project structure. See <URL:http://www.altrasoft.com/> for more details +project structure. See @uref{http://www.altrasoft.com/, the Altrasoft +web site} for more details or contact Altrasoft directly at 1-888-ALTSOFT. The closest existing port is @dfn{Win-Emacs}, which is based on Lucid -Emacs 19.6. Available from <URL:http://www.pearlsoft.com/>. +Emacs 19.6. Available from @uref{http://www.pearlsoft.com/}. There's a port of GNU Emacs (not XEmacs) at @example -<URL:http://www.cs.washington.edu/homes/voelker/ntemacs.html>. +@uref{http://www.cs.washington.edu/homes/voelker/ntemacs.html}. @end example @node Q1.0.11, Q1.0.12, Q1.0.10, Introduction -@section Is there a port of XEmacs to the Macintosh? +@unnumberedsubsec Q1.0.11: Is there a port of XEmacs to the Macintosh? There has been a port to the MachTen environment of XEmacs 19.13, but no patches have been submitted to the maintainers to get this in the mainstream distribution. @node Q1.0.12, Q1.0.13, Q1.0.11, Introduction -@section Is there a port of XEmacs to NextStep? - -Carl Edman, apparently no longer at <cedman@@princeton.edu>, did the -port of GNU Emacs to NeXTstep and expressed interest in doing the XEmacs -port, but never went any farther. +@unnumberedsubsec Q1.0.12: Is there a port of XEmacs to NextStep? + +Carl Edman, apparently no longer at @email{cedman@@princeton.edu}, did +the port of GNU Emacs to NeXTstep and expressed interest in doing the +XEmacs port, but never went any farther. @node Q1.0.13, Q1.0.14, Q1.0.12, Introduction -@section Is there a port of XEmacs to OS/2? +@unnumberedsubsec Q1.0.13: Is there a port of XEmacs to OS/2? No, and there is no news of anyone working on it. @node Q1.0.14, Q1.1.1, Q1.0.13, Introduction -@section Where can I obtain a printed copy of the XEmacs users manual? +@unnumberedsubsec Q1.0.14: Where can I obtain a printed copy of the XEmacs users manual? Altrasoft Associates, a firm specializing in Emacs-related support and development, will be maintaining the XEmacs user manual. The firm plans @@ -630,13 +644,14 @@ @c This used to say `March 1997'! @example - Web: http://www.xemacs.com - E-mail: <info@@xemacs.com> + Web: @uref{http://www.xemacs.com} + E-mail: @email{info@@xemacs.com} Tel: +1 408 243 3300 @end example @node Q1.1.1, Q1.1.2, Q1.0.14, Introduction -@section What is the FAQ editorial policy? +@unnumberedsec 1.1: Policies +@unnumberedsubsec Q1.1.1: What is the FAQ editorial policy? The FAQ is actively maintained and modified regularly. All links should be up to date. @@ -646,8 +661,11 @@ month. Preexisting questions that have been changed are marked as such. Brand new questions are tagged. -All submissions are welcome. E-mail submissions to Andreas Kaempf -<andreas@@sccon.com>. +All submissions are welcome. E-mail submissions +to @iftex +@* +@end iftex +@email{chr@@mediascience.no, Christian Nyb@o{}}. Please make sure that @samp{XEmacs FAQ} appears on the Subject: line. If you think you have a better way of answering a question, or think a @@ -660,18 +678,18 @@ author. @node Q1.1.2, Q1.1.3, Q1.1.1, Introduction -@section How do I become a Beta Tester? - -Send an email message to <xemacs-beta-request@@xemacs.org> with a -subject line of @samp{subscribe}. +@unnumberedsubsec Q1.1.2: How do I become a Beta Tester? + +Send an email message to @email{xemacs-beta-request@@xemacs.org} with a +subject line of @samp{subscribe}. Be prepared to get your hands dirty, as beta testers are expected to identify problems as best they can. @node Q1.1.3, Q1.2.1, Q1.1.2, Introduction -@section How do I contribute to XEmacs itself? - -Ben Wing <ben@@666.com> writes: +@unnumberedsubsec Q1.1.3: How do I contribute to XEmacs itself? + +Ben Wing @email{ben@@666.com} writes: @quotation BTW if you have a wish list of things that you want added, you have to @@ -701,28 +719,50 @@ @end quotation @node Q1.2.1, Q1.2.2, Q1.1.3, Introduction -@section Who wrote XEmacs? +@unnumberedsec 1.2: Credits +@unnumberedsubsec Q1.2.1: Who wrote XEmacs? XEmacs is the result of the time and effort of many people. The developers responsible for the 19.16/20.x releases are: @itemize @bullet -@item Martin Buchholz <martin@@xemacs.org> - -@item Steve Baur <steve@@altair.xemacs.org> - -@item Hrvoje Niksic <hniksic@@srce.hr> +@item @email{martin@@xemacs.org, Martin Buchholz} +@ifhtml +<img src="mrb.jpeg"> +@end ifhtml + + +@item @email{steve@@altair.xemacs.org, Steve Baur} + +@ifhtml +<img src="steve.gif"> +@end ifhtml + + +@item @email{hniksic@@srce.hr, Hrvoje Niksic} + +@ifhtml +<img src="hniksic.jpeg"> +@end ifhtml + @end itemize The developers responsible for the 19.14 release are: @itemize @bullet -@item Chuck Thompson <cthomp@@xemacs.org> +@item @email{cthomp@@xemacs.org, Chuck Thompson} +@ifhtml +<img src="cthomp.jpeg"> +@end ifhtml Chuck was Mr. XEmacs from 19.11 through 19.14, and is responsible for XEmacs becoming a widely distributed program over the Internet. -@item Ben Wing <ben@@666.com> +@item @email{ben@@666.com, Ben Wing} +@ifhtml +<img src="wing.gif"> +@end ifhtml + @end itemize Jamie Zawinski was Mr. Lucid Emacs from 19.0 through 19.10, the last @@ -730,81 +770,85 @@ most of those releases. @itemize @bullet -@item Jamie Zawinski <jwz@@netscape.com> - -@item Richard Mlynarik <mly@@adoc.xerox.com> +@item @email{jwz@@netscape.com, Jamie Zawinski} +@ifhtml +<img src="jwz.gif"> +@end ifhtml + +@item @email{mly@@adoc.xerox.com, Richard Mlynarik} @end itemize Along with many other contributors, partially enumerated in the @samp{About XEmacs} option in the Help menu. @node Q1.2.2, Q1.2.3, Q1.2.1, Introduction -@section Who contributed to this version of the FAQ? +@unnumberedsubsec Q1.2.2: Who contributed to this version of the FAQ? The following people contributed valuable suggestions to building this version of the FAQ (listed in alphabetical order): @itemize @bullet -@item SL Baur <steve@@xemacs.org> - -@item Hrvoje Niksic <hniksic@@srce.hr> - -@item Aki Vehtari <Aki.Vehtari@@hut.fi> +@item @email{steve@@xemacs.org, SL Baur} + +@item @email{hniksic@@srce.hr, Hrvoje Niksic} + +@item @email{Aki.Vehtari@@hut.fi, Aki Vehtari} @end itemize @node Q1.2.3, Q1.3.1, Q1.2.2, Introduction -@section Who contributed to the FAQ in the past? +@unnumberedsubsec Q1.2.3: Who contributed to the FAQ in the past? This is only a partial list, as many names were lost in a hard disk crash some time ago. @itemize @bullet -@item Curtis.N.Bingham <binge@@aloft.att.com> - -@item Richard Caley <rjc@@cogsci.ed.ac.uk> - -@item Richard Cognot <cognot@@ensg.u-nancy.fr> - -@item William G. Dubuque <wgd@@martigny.ai.mit.edu> - -@item Eric Eide <eeide@@cs.utah.edu> - -@item Chris Flatters <cflatter@@nrao.edu> - -@item Evelyn Ginsparg <ginsparg@@adra.com> - -@item Marty Hall <hall@@aplcenmp.apl.jhu.edu> - -@item Darrell Kindred <dkindred@@cmu.edu> - -@item David Moore <dmoore@@ucsd.edu> - -@item Arup Mukherjee <arup+@@cmu.edu> - -@item Juergen Nickelsen <nickel@@prz.tu-berlin.de> - -@item Kevin R. Powell <powell@@csl.ncsa.uiuc.edu> - -@item Justin Sheehy <dworkin@@ccs.neu.edu> - -@item Stig <stig@@hackvan.com> - -@item Aki Vehtari <Aki.Vehtari@@hut.fi> +@item @email{binge@@aloft.att.com, Curtis.N.Bingham} + +@item @email{rjc@@cogsci.ed.ac.uk, Richard Caley} + +@item @email{cognot@@ensg.u-nancy.fr, Richard Cognot} + +@item @email{wgd@@martigny.ai.mit.edu, William G. Dubuque} + +@item @email{eeide@@cs.utah.edu, Eric Eide} + +@item @email{cflatter@@nrao.edu, Chris Flatters} + +@item @email{ginsparg@@adra.com, Evelyn Ginsparg} + +@item @email{hall@@aplcenmp.apl.jhu.edu, Marty Hall} + +@item @email{dkindred@@cmu.edu, Darrell Kindred} + +@item @email{dmoore@@ucsd.edu, David Moore} + +@item @email{arup+@@cmu.edu, Arup Mukherjee} + +@item @email{nickel@@prz.tu-berlin.de, Juergen Nickelsen} + +@item @email{powell@@csl.ncsa.uiuc.edu, Kevin R. Powell} + +@item @email{dworkin@@ccs.neu.edu, Justin Sheehy} + +@item @email{stig@@hackvan.com, Stig} + +@item @email{Aki.Vehtari@@hut.fi, Aki Vehtari} @end itemize @node Q1.3.1, Q1.3.2, Q1.2.3, Introduction -@section What is the status of XEmacs v20? +@unnumberedsec 1.3: Internationalization +@unnumberedsubsec Q1.3.1: What is the status of XEmacs v20? XEmacs v20 is the version of XEmacs that includes MULE (Asian-language) support. XEmacs 20.0 was released in February 1997, followed by XEmacs -20.2 in May and XEmacs 20.3 in November. When compiled without MULE -support, 20.3 is approximately as stable as 19.16, and probably faster +20.2 in May, XEmacs 20.3 in November and XEmacs 20.4 in February 1998. When compiled without MULE +support, 20.4 is approximately as stable as 19.16, and probably faster (due to additional optimization work.) As of XEmacs 20.3, version 20 is @emph{the} supported version of XEmacs. This means that 19.16 will optionally receive stability fixes -(if any), but that all the real development work will be done on the v20 +(if any), but that all the real development work will be done on the v20 tree. The incompatible changes in XEmacs 20 include the additional byte-codes, @@ -815,7 +859,7 @@ However, to avoid breaking old code, many functions that should normally accept characters work with integers, and vice versa. For more -information, see the Lisp reference manual. Here is a relevant excerpt, +information, see the Lisp reference manual. Here is a relevant excerpt, for your convenience. @quotation @@ -865,26 +909,26 @@ @end quotation @node Q1.3.2, Q1.3.3, Q1.3.1, Introduction -@section What is the status of Asian-language support, aka MULE? +@unnumberedsubsec Q1.3.2: What is the status of Asian-language support, aka MULE? The MULE support works OK but still needs a fair amount of work before it's really solid. We could definitely use some help here, esp. people who speak Japanese and will use XEmacs/MULE to work with Japanese and have some experience with E-Lisp. -As the funding on Mule have stopped, Mule part of XEmacs is currently +As the fundings on Mule have stopped, Mule part of XEmacs is currently looking for a full-time maintainer. If you can provide help here, or -are willing to fund the work, please mail to <xemacs-beta@@xemacs.org>. +are willing to fund the work, please mail to @email{xemacs-beta@@xemacs.org}. @xref{Q1.1.2}. @node Q1.3.3, Q1.3.4, Q1.3.2, Introduction -@section How do I type non-ASCII characters? +@unnumberedsubsec Q1.3.3: How do I type non-ASCII characters? See question 3.5.7 (@xref{Q3.5.7}) in part 3 of this FAQ. @node Q1.3.4, Q1.3.5, Q1.3.3, Introduction -@section Can XEmacs messages come out in a different language? +@unnumberedsubsec Q1.3.4: Can XEmacs messages come out in a different language? The message-catalog support has mostly been written but doesn't currently work. The first release of XEmacs 20 will @emph{not} support @@ -901,12 +945,12 @@ removing punctuation and capitalizing as above. @node Q1.3.5, Q1.3.6, Q1.3.4, Introduction -@section Please explain the various input methods in MULE/XEmacs 20.0 - -MORIOKA Tomohiko <morioka@@jaist.ac.jp> writes: +@unnumberedsubsec Q1.3.5: Please explain the various input methods in MULE/XEmacs 20.0 + +@email{morioka@@jaist.ac.jp, MORIOKA Tomohiko} writes: @quotation -Original Mule supports the following input methods: Wnn4, Wnn6, Canna, SJ3 +Original Mule supports following input methods: Wnn4, Wnn6, Canna, SJ3 and XIM. Interfaces for Wnn and SJ3 uses the @code{egg} user interface. Interface for Canna does not use @samp{egg}. I don't know about XIM. It is to support ATOK, of course, it may work for another @@ -950,9 +994,9 @@ @end quotation @node Q1.3.6, Q1.3.7, Q1.3.5, Introduction -@section How do I portably code for MULE/XEmacs 20? - -MORIOKA Tomohiko <morioka@@jaist.ac.jp> writes: +@unnumberedsubsec Q1.3.6: How do I portably code for MULE/XEmacs 20? + +@email{morioka@@jaist.ac.jp, MORIOKA Tomohiko} writes: @quotation MULE and XEmacs are quite different. So the application @@ -999,34 +1043,42 @@ @end quotation @node Q1.3.7, Q1.4.1, Q1.3.6, Introduction -@section How about Cyrillic Modes? - -Ilya Zakharevich <ilya@@math.ohio-state.edu> writes: +@unnumberedsubsec Q1.3.7: How about Cyrillic Modes? + +@email{ilya@@math.ohio-state.edu, Ilya Zakharevich} writes: @quotation There is a cyrillic mode in the file @file{mysetup.zip} in -<URL:ftp://ftp.math.ohio-state.edu/pub/users/ilya/emacs/>. This is a -modification to Valery Alexeev's <ava@@math.jhu.ed> @file{russian.el} -which can be obtained from <URL:ftp://ftp.cis.ohio-state.edu/pub/gnu/emacs/elisp-archive/packages/russian.el.Z>. +@iftex +@* +@end iftex +@uref{ftp://ftp.math.ohio-state.edu/pub/users/ilya/emacs/}. This is a +modification to @email{ava@@math.jhu.ed, Valery Alexeev's} @file{russian.el} +which can be obtained from @uref{ftp://ftp.cis.ohio-state.edu/pub/gnu/emacs/elisp-archive/packages/russian.el.Z}. @end quotation -Dima Barsky <d.barsky@@ee.surrey.ac.uk> writes: +@email{d.barsky@@ee.surrey.ac.uk, Dima Barsky} writes: @quotation -There is another cyrillic mode for both GNU Emacs and XEmacs by Dmitrii -(Mitya) Manin <manin@@camelot.mssm.edu> at -<URL:http://camelot.mssm.edu/~manin/cyr.el>. +There is another cyrillic mode for both GNU Emacs and XEmacs by +@email{manin@@camelot.mssm.edu, Dmitrii +(Mitya) Manin} at +@iftex + +@end iftex +@uref{http://camelot.mssm.edu/~manin/cyr.el}. @end quotation -Rebecca Ore <rebecca.ore@@op.net> writes: +@email{rebecca.ore@@op.net, Rebecca Ore} writes: @quotation The fullest resource I found on Russian language use (in and out of -XEmacs) is <URL:http://sunsite.oit.unc.edu/sergei/Software/Software.html> +XEmacs) is @uref{http://sunsite.oit.unc.edu/sergei/Software/Software.html} @end quotation @node Q1.4.1, Q1.4.2, Q1.3.7, Introduction -@section What is a @file{.emacs} and is there a sample one? +@unnumberedsec 1.4: Getting Started, Backing up & Recovery +@unnumberedsubsec Q1.4.1: What is a @file{.emacs} and is there a sample one? The @file{.emacs} file is used to customize XEmacs to your tastes. No two are alike, nor are they expected to be alike, but that's the point. @@ -1040,28 +1092,34 @@ @kbd{C-h v data-directory RET}. @node Q1.4.2, Q1.4.3, Q1.4.1, Introduction -@section Can I use the same @file{.emacs} with the other Emacs? +@unnumberedsubsec Q1.4.2: Can I use the same @file{.emacs} with the other Emacs? Yes. The sample @file{.emacs} included in the XEmacs distribution will show you how to handle different versions and flavors of Emacs. @node Q1.4.3, Q1.4.4, Q1.4.2, Introduction -@section Any good tutorials around? +@unnumberedsubsec Q1.4.3: Any good tutorials around? There's the XEmacs tutorial available from the Help Menu, or by typing -@kbd{C-h t}. +@kbd{C-h t}. To check whether it's available in a non-english language, +type @kbd{C-u C-h t TAB}, type the first letters of your preferred +language, then type @kbd{RET}. There's an Emacs Lisp tutorial at @example -<URL:ftp://prep.ai.mit.edu/pub/gnu/emacs-lisp-intro-1.04.tar.gz>. +@uref{ftp://prep.ai.mit.edu/pub/gnu/emacs-lisp-intro-1.04.tar.gz}. @end example -Erik Sundermann <erik@@petaxp.rug.ac.be> has made a tutorial web page at -<URL:http://petaxp.rug.ac.be/~erik/xemacs/>. +@email{erik@@petaxp.rug.ac.be, Erik Sundermann} has made a tutorial web +page at +@iftex +@* +@end iftex +@uref{http://petaxp.rug.ac.be/~erik/xemacs/}. @node Q1.4.4, Q1.4.5, Q1.4.3, Introduction -@section May I see an example of a useful XEmacs Lisp function? +@unnumberedsubsec Q1.4.4: May I see an example of a useful XEmacs Lisp function? The following function does a little bit of everything useful. It does something with the prefix argument, it examines the text around the @@ -1096,7 +1154,7 @@ @code{interactive} allows you to execute the command with @kbd{M-x}. @node Q1.4.5, Q1.4.6, Q1.4.4, Introduction -@section And how do I bind it to a key? +@unnumberedsubsec Q1.4.5: And how do I bind it to a key? To bind to a key do: @@ -1107,7 +1165,7 @@ Or interactively, @kbd{M-x global-set-key} and follow the prompts. @node Q1.4.6, Q1.4.7, Q1.4.5, Introduction -@section What's the difference between a macro and a function? +@unnumberedsubsec Q1.4.6: What's the difference between a macro and a function? Quoting from the Lisp Reference (a.k.a @dfn{Lispref}) Manual: @@ -1127,7 +1185,7 @@ other keys. Refer to manual for details. @node Q1.4.7, , Q1.4.6, Introduction -@section How come options saved with 19.13 don't work with 19.14 or later? +@unnumberedsubsec Q1.4.7: How come options saved with 19.13 don't work with 19.14 or later? There's a problem with options of the form: @@ -1152,32 +1210,32 @@ (or (and (= emacs-major-version 19) (>= emacs-minor-version 12)) (>= emacs-major-version 20))) - ... - )) + ... + )) @end lisp @node Installation, Customization, Introduction, Top -@chapter Installation and Trouble Shooting +@unnumbered 2 Installation and Trouble Shooting This is part 2 of the XEmacs Frequently Asked Questions list. This section is devoted to Installation, Maintenance and Trouble Shooting. @menu Installation: -* Q2.0.1:: Running XEmacs without installing. -* Q2.0.2:: XEmacs is too big. +* Q2.0.1:: Running XEmacs without installing. +* Q2.0.2:: XEmacs is too big. * Q2.0.3:: Compiling XEmacs with Netaudio. * Q2.0.4:: Problems with Linux and ncurses. * Q2.0.5:: Do I need X11 to run XEmacs? * Q2.0.6:: I'm having strange crashes. What do I do? * Q2.0.7:: Libraries in non-standard locations. * Q2.0.8:: can't resolve symbol _h_errno -* Q2.0.9:: Where do I find external libraries? +* Q2.0.9:: Where do I find external libraries? * Q2.0.10:: After I run configure I find a coredump, is something wrong? * Q2.0.11:: XEmacs can't resolve host names. -* Q2.0.12:: Why can't I strip XEmacs? +* Q2.0.12:: Why can't I strip XEmacs? * Q2.0.13:: Can't link XEmacs on Solaris with Gcc. -* Q2.0.14:: Make on HP/UX 9 fails after linking temacs +* Q2.0.14:: Make on HP/UX 9 fails after linking temacs Trouble Shooting: * Q2.1.1:: XEmacs just crashed on me! @@ -1206,8 +1264,8 @@ @end menu @node Q2.0.1, Q2.0.2, Installation, Installation -@section Running XEmacs without installing - +@unnumberedsec 2.0: Installation +@unnumberedsubsec Q2.0.1: Running XEmacs without installing The @file{INSTALL} file says that up to 108 MB of space is needed temporarily during installation! How can I just try it out? @@ -1228,12 +1286,12 @@ This will let you run XEmacs without massive copying. @node Q2.0.2, Q2.0.3, Q2.0.1, Installation -@section XEmacs is too big +@unnumberedsubsec Q2.0.2: XEmacs is too big Although this entry has been written for XEmacs 19.13, most of it still stands true. -Steve Baur <steve@@altair.xemacs.org> writes: +@email{steve@@altair.xemacs.org, Steve Baur} writes: @quotation The 45MB of space required by the installation directories can be @@ -1360,7 +1418,7 @@ @strong{and} can be achieved without deleting a single file. @end quotation -giacomo boffi <boffi@@hp735.stru.polimi.it> provides this procedure: +@email{boffi@@hp735.stru.polimi.it, Giacomo Boffi} provides this procedure: @quotation Substitute @file{/usr/local/lib/} with the path where the xemacs tree is @@ -1380,8 +1438,8 @@ cd $d for f in *.el ; do # compress (remove) only (ONLY) the sources that have a -# corresponding compiled file --- do not (DO NOT) touch other -# sources +# corresponding compiled file --- do not (DO NOT) +# touch other sources if test -f $@{f@}c ; then gzip -v9 $f >> $r/cmpr ; fi done cd .. @@ -1406,7 +1464,7 @@ @end quotation @node Q2.0.3, Q2.0.4, Q2.0.2, Installation -@section Compiling XEmacs with Netaudio. +@unnumberedsubsec Q2.0.3: Compiling XEmacs with Netaudio. What is the best way to compile XEmacs with the netaudio system, since I have got the netaudio system compiled but installed at a weird place, I @@ -1432,20 +1490,23 @@ BTW, netaudio has been renamed as it has a name clash with something else, so if you see references to NAS or Network Audio System, it's the same thing. It also might be found at -<URL:ftp.x.org:/contrib/audio/nas/>. +@uref{ftp://ftp.x.org/contrib/audio/nas/}. @node Q2.0.4, Q2.0.5, Q2.0.3, Installation -@section Problems with Linux and ncurses. +@unnumberedsubsec Q2.0.4: Problems with Linux and ncurses. On Linux 1.3.98 with termcap 2.0.8 and the ncurses that came with libc 5.2.18, XEmacs 20.0b20 is unable to open a tty device: @example src/xemacs -nw -q -Initialization error: Terminal type `xterm' undefined (or can't access database?) +Initialization error: @iftex +@* +@end iftex +Terminal type `xterm' undefined (or can't access database?) @end example -Ben Wing <ben@@666.com> writes: +@email{ben@@666.com, Ben Wing} writes: @quotation Your ncurses configuration is messed up. Your /usr/lib/terminfo is a @@ -1453,7 +1514,7 @@ @end quotation @node Q2.0.5, Q2.0.6, Q2.0.4, Installation -@section Do I need X11 to run XEmacs? +@unnumberedsubsec Q2.0.5: Do I need X11 to run XEmacs? No. The name @dfn{XEmacs} is unfortunate in the sense that it is @strong{not} an X Window System-only version of Emacs. Starting with @@ -1461,14 +1522,14 @@ terminal. @node Q2.0.6, Q2.0.7, Q2.0.5, Installation -@section I'm having strange crashes. What do I do? +@unnumberedsubsec Q2.0.6: I'm having strange crashes. What do I do? There have been a variety of reports of crashes due to compilers with buggy optimizers. Please see the @file{PROBLEMS} file that comes with XEmacs to read what it says about your platform. @node Q2.0.7, Q2.0.8, Q2.0.6, Installation -@section Libraries in non-standard locations +@unnumberedsubsec Q2.0.7: Libraries in non-standard locations I have x-faces, jpeg, xpm etc. all in different places. I've tried space-separated, comma-separated, several --site-libraries, all to no @@ -1479,7 +1540,7 @@ @end example @node Q2.0.8, Q2.0.9, Q2.0.7, Installation -@section can't resolve symbol _h_errno +@unnumberedsubsec Q2.0.8: can't resolve symbol _h_errno You are using the Linux/ELF distribution of XEmacs 19.14, and your ELF libraries are out of date. You have the following options: @@ -1491,7 +1552,10 @@ @item Patch the XEmacs binary by replacing all occurrences of -@samp{_h_errno^@@} with @samp{h_errno^@@^@@}. Any version of Emacs will +@samp{_h_errno^@@} with @iftex +@* +@end iftex +@samp{h_errno^@@^@@}. Any version of Emacs will suffice. If you don't understand how to do this, don't do it. @item @@ -1499,13 +1563,14 @@ O.K. @end enumerate -Hrvoje Niksic <hniksic@@srce.hr> writes: +@email{hniksic@@srce.hr, Hrvoje Niksic} writes: @quotation Why not use a Perl one-liner for No. 2? @example -perl -pi -e 's/_h_errno\0/h_errno\0\0/g' /usr/local/bin/xemacs-19.14 +perl -pi -e 's/_h_errno\0/h_errno\0\0/g' \ +/usr/local/bin/xemacs-19.14 @end example NB: You @emph{must} patch @file{/usr/local/bin/xemacs-19.14}, and not @@ -1514,7 +1579,7 @@ a symbolic link. @end quotation -SL Baur <steve@@xemacs.org> writes: +@email{steve@@xemacs.org, SL Baur} writes: @quotation If you build against a recent libc-5.4 (late enough to have caused @@ -1533,10 +1598,14 @@ @end quotation @node Q2.0.9, Q2.0.10, Q2.0.8, Installation -@section Where do I find external libraries? +@unnumberedsubsec Q2.0.9: Where do I find external libraries? All external libraries used by XEmacs can be found at the XEmacs FTP -site <URL:ftp://ftp.xemacs.org/pub/aux/>. +site +@iftex +@* +@end iftex +@uref{ftp://ftp.xemacs.org/pub/aux/}. @c This list is a pain in the you-know-what to keep in synch with the @c world. @@ -1544,37 +1613,37 @@ @table @asis @item JPEG -<URL:ftp://ftp.uu.net/graphics/jpeg/>. Version 6a is current. +@uref{ftp://ftp.uu.net/graphics/jpeg/}. Version 6a is current. @item XPM -<URL:ftp://ftp.x.org/contrib/libraries/>. Version 3.4j is current. +@uref{ftp://ftp.x.org/contrib/libraries/}. Version 3.4j is current. Older versions of this package are known to cause XEmacs crashes. @item TIFF -<URL:ftp://ftp.sgi.com/graphics/tiff/>. v3.4 is current. The latest +@uref{ftp://ftp.sgi.com/graphics/tiff/}. v3.4 is current. The latest beta is v3.4b035. There is a HOWTO here. @item PNG -<URL:ftp://ftp.uu.net/graphics/png/>. 0.89c is current. XEmacs +@uref{ftp://ftp.uu.net/graphics/png/}. 0.89c is current. XEmacs requires a fairly recent version to avoid using temporary files. -<URL:ftp://swrinde.nde.swri.edu/pub/png/src/> +@uref{ftp://swrinde.nde.swri.edu/pub/png/src/} @item Compface -<URL:ftp://ftp.cs.indiana.edu/pub/faces/compface/>. This library has +@uref{ftp://ftp.cs.indiana.edu/pub/faces/compface/}. This library has been frozen for about 6 years, and is distributed without version numbers. @emph{It should be compiled with the same options that X11 was compiled with on your system}. The version of this library at XEmacs.org includes the @file{xbm2xface.pl} script, written by -stig@@hackvan.com, which may be useful when generating your own xface. +@email{stig@@hackvan.com}, which may be useful when generating your own xface. @item NAS -<URL:ftp://ftp.x.org/contrib/audio/nas/>. +@uref{ftp://ftp.x.org/contrib/audio/nas/}. Version 1.2p5 is current. There is a FAQ here. @end table @node Q2.0.10, Q2.0.11, Q2.0.9, Installation -@section After I run configure I find a core dump, is something wrong? +@unnumberedsubsec Q2.0.10: After I run configure I find a core dump, is something wrong? Not necessarily. If you have GNU sed 3.0 you should downgrade it to 2.05. From the @file{README} at prep.ai.mit.edu: @@ -1593,12 +1662,12 @@ core dump. @node Q2.0.11, Q2.0.12, Q2.0.10, Installation -@section XEmacs doesn't resolve hostnames. +@unnumberedsubsec Q2.0.11: XEmacs doesn't resolve hostnames. This is the result of a long-standing problem with SunOS and the fact that stock SunOS systems do not ship with DNS resolver code in libc. -Christopher Davis <ckd@@loiosh.kei.com> writes: +@email{ckd@@loiosh.kei.com, Christopher Davis} writes: @quotation That's correct [The SunOS 4.1.3 precompiled binaries don't do name @@ -1614,9 +1683,9 @@ @end quotation @node Q2.0.12, Q2.0.13, Q2.0.11, Installation -@section Why can't I strip XEmacs? - -Richard Cognot <cognot@@fronsac.ensg.u-nancy.fr> writes: +@unnumberedsubsec Q2.0.12: Why can't I strip XEmacs? + +@email{cognot@@fronsac.ensg.u-nancy.fr, Richard Cognot} writes: @quotation Because of the way XEmacs (and every other Emacsen, AFAIK) is built. The @@ -1638,7 +1707,7 @@ kits). @end quotation -Nat Makarevitch <nat@@nataa.fr.eu.org> writes: +@email{nat@@nataa.fr.eu.org, Nat Makarevitch} writes: @quotation Here is the trick: @@ -1660,23 +1729,27 @@ cp src/xemacs /usr/local/bin/xemacs @item -cp lib-src/DOC-19.16-XEmacs /usr/local/lib/xemacs-19.16/i586-unknown-linuxaout +cp lib-src/DOC-19.16-XEmacs +@iftex +\ @* +@end iftex +/usr/local/lib/xemacs-19.16/i586-unknown-linuxaout @end enumerate @end quotation @node Q2.0.13, Q2.0.14, Q2.0.12, Installation -@section Problems linking with Gcc on Solaris +@unnumberedsubsec Q2.0.13: Problems linking with Gcc on Solaris There are known difficulties linking with Gnu ld on Solaris. A typical error message might look like: @example -unexec(): dlopen(../dynodump/dynodump.so): ld.so.1: ./temacs: -fatal: relocation error: +unexec(): dlopen(../dynodump/dynodump.so): ld.so.1: ./temacs: +fatal: relocation error: symbol not found: main: referenced in ../dynodump/dynodump.so @end example -Martin Buchholz <martin@@xemacs.org> writes: +@email{martin@@xemacs.org, Martin Buchholz} writes: @quotation You need to specify @samp{-fno-gnu-linker} as part of your flags to pass @@ -1684,11 +1757,11 @@ @end quotation @node Q2.0.14, Q2.1.1, Q2.0.13, Installation -@section Make on HP/UX 9 fails after linking temacs +@unnumberedsubsec Q2.0.14: Make on HP/UX 9 fails after linking temacs Problem when building xemacs-19.16 on hpux 9: -Richard Cognot <cognot@@ensg.u-nancy.fr> writes: +@email{cognot@@ensg.u-nancy.fr, Richard Cognot} writes: @quotation make on hpux fails after linking temacs with a message: @@ -1704,7 +1777,8 @@ @node Q2.1.1, Q2.1.2, Q2.0.14, Installation -@section Help! XEmacs just crashed on me! +@unnumberedsec 2.1: Trouble Shooting +@unnumberedsubsec Q2.1.1: Help! XEmacs just crashed on me! First of all, don't panic. Whenever XEmacs crashes, it tries extremely hard to auto-save all of your files before dying. (The main time that @@ -1722,7 +1796,7 @@ come up with a reproducible way of doing this (or even if you have a pretty good memory of exactly what you were doing at the time), the maintainers would be very interested in knowing about it. Post a -message to comp.emacs.xemacs or send mail to <crashes@@xemacs.org>. +message to comp.emacs.xemacs or send mail to @email{crashes@@xemacs.org}. Please note that the @samp{crashes} address is exclusively for crash reports. @@ -1774,7 +1848,7 @@ @end enumerate @node Q2.1.2, Q2.1.3, Q2.1.1, Installation -@section Cryptic Minibuffer messages. +@unnumberedsubsec Q2.1.2: Cryptic Minibuffer messages. When I try to use some particular option of some particular package, I get a cryptic error in the minibuffer. @@ -1805,7 +1879,7 @@ command is bound to @kbd{C-h l} by default. @node Q2.1.3, Q2.1.4, Q2.1.2, Installation -@section Translation Table Syntax messages at Startup +@unnumberedsubsec Q2.1.3: Translation Table Syntax messages at Startup I get tons of translation table syntax error messages during startup. How do I get rid of them? @@ -1822,6 +1896,9 @@ set the environment variable @var{XKEYSYMDB} to the location of the @file{XKeysymDB} file on your system or to the location of the one included with XEmacs which should be at +@iftex +@* +@end iftex @file{<xemacs_root_directory>/lib/xemacs-19.16/etc/XKeysymDB}. @item @@ -1833,7 +1910,7 @@ @end itemize @node Q2.1.4, Q2.1.5, Q2.1.3, Installation -@section Startup warnings about deducing proper fonts? +@unnumberedsubsec Q2.1.4: Startup warnings about deducing proper fonts? How can I avoid the startup warnings about deducing proper fonts? @@ -1860,7 +1937,7 @@ The buffer still exists; it just isn't in your face. @node Q2.1.5, Q2.1.6, Q2.1.4, Installation -@section XEmacs cannot connect to my X Terminal! +@unnumberedsubsec Q2.1.5: XEmacs cannot connect to my X Terminal! Help! I can not get XEmacs to display on my Envizex X-terminal! @@ -1868,7 +1945,7 @@ the host you are running XEmacs from. @node Q2.1.6, Q2.1.7, Q2.1.5, Installation -@section XEmacs just locked up my Linux X server! +@unnumberedsubsec Q2.1.6: XEmacs just locked up my Linux X server! There have been several reports of the X server locking up under Linux. In all reported cases removing speedo and scaled fonts from the font @@ -1878,7 +1955,7 @@ It is possible that using a font server may also solve the problem. @node Q2.1.7, Q2.1.8, Q2.1.6, Installation -@section HP Alt key as Meta. +@unnumberedsubsec Q2.1.7: HP Alt key as Meta. How can I make XEmacs recognize the Alt key of my HP workstation as a Meta key? @@ -1891,9 +1968,9 @@ @end example @node Q2.1.8, Q2.1.9, Q2.1.7, Installation -@section got (wrong-type-argument color-instance-p nil) - -Natalie Kershaw <nataliek@@rd.scitec.com.au> writes: +@unnumberedsubsec Q2.1.8: got (wrong-type-argument color-instance-p nil) + +@email{nataliek@@rd.scitec.com.au, Natalie Kershaw} writes: @quotation I am trying to run xemacs 19.13 under X11R4. Whenever I move the mouse I @@ -1901,11 +1978,13 @@ doesn't occur on X11R5. @lisp -Signalling: (error "got (wrong-type-argument color-instance-p nil) and I don't know why!") +Signalling: +(error "got (wrong-type-argument color-instance-p nil) +and I don't know why!") @end lisp @end quotation -dinos <map01kd@@gold.ac.uk> writes: +@email{map01kd@@gold.ac.uk, dinos} writes: @quotation I think this is due to undefined resources; You need to define color @@ -1932,15 +2011,15 @@ xemacs*pointerColor: black @end example -With the new colors installed the problem still occurs if the above +With the new colours installed the problem still occurs if the above resources are not defined. -If the new colors are not present then an additional error occurs on +If the new colours are not present then an additional error occurs on XEmacs startup, which says @samp{Color Red3} not defined. @end quotation @node Q2.1.9, Q2.1.10, Q2.1.8, Installation -@section XEmacs causes my OpenWindows 3.0 server to crash. +@unnumberedsubsec Q2.1.9: XEmacs causes my OpenWindows 3.0 server to crash. The OpenWindows 3.0 server is incredibly buggy. Your best bet is to replace it with one from the generic MIT X11 release. You might also @@ -1948,7 +2027,7 @@ pixmaps. @node Q2.1.10, Q2.1.11, Q2.1.9, Installation -@section Warnings from incorrect key modifiers. +@unnumberedsubsec Q2.1.10: Warnings from incorrect key modifiers. The following information comes from the @file{PROBLEMS} file that comes with XEmacs. @@ -1974,42 +2053,42 @@ @end example @node Q2.1.11, Q2.1.12, Q2.1.10, Installation -@section [This question intentionally left blank] +@unnumberedsubsec Q2.1.11: [This question intentionally left blank] Obsolete question, left blank to avoid renumbering. @node Q2.1.12, Q2.1.13, Q2.1.11, Installation -@section Problems with Regular Expressions on DEC OSF1. +@unnumberedsubsec Q2.1.12: Problems with Regular Expressions on DEC OSF1. I have xemacs 19.13 running on an alpha running OSF1 V3.2 148 and ispell would not run because it claimed the version number was incorrect although it was indeed OK. I traced the problem to the regular expression handler. -Douglas Kosovic <douglask@@dstc.edu.au> writes: +@email{douglask@@dstc.edu.au, Douglas Kosovic} writes: @quotation -Actually it's a DEC cc optimization bug that screws up the regexp +Actually it's a DEC cc optimisation bug that screws up the regexp handling in XEmacs. Rebuilding using the @samp{-migrate} switch for DEC cc (which uses a -different sort of optimization) works fine. +different sort of optimisation) works fine. @end quotation See @file{xemacs-19_13-dunix-3_2c.patch} at the following URL on how to build with the @samp{-migrate} flag: @example -<URL:http://www-digital.cern.ch/carney/emacs/emacs.html> +@uref{http://www-digital.cern.ch/carney/emacs/emacs.html} @end example NOTE: There have been a variety of other problems reported that are fixed in this fashion. @node Q2.1.13, Q2.1.14, Q2.1.12, Installation -@section HP/UX 10.10 and @code{create_process} failure. - -Dave Carrigan <Dave.Carrigan@@ipl.ca> writes: +@unnumberedsubsec Q2.1.13: HP/UX 10.10 and @code{create_process} failure. + +@email{Dave.Carrigan@@ipl.ca, Dave Carrigan} writes: @quotation With XEmacs 19.13 and HP/UX 10.10, anything that relies on the @@ -2017,7 +2096,7 @@ (shell-mode, compile, ange-ftp, to name a few). @end quotation -Phil Johnson <johnson@@dtc.hp.com> writes: +@email{johnson@@dtc.hp.com, Phil Johnson} writes: @quotation This is a problem specific to HP-UX 10.10. It only occurs when XEmacs @@ -2029,7 +2108,7 @@ if it's a kernel problem which crept into 10.10. @end quotation -Richard Cognot <cognot@@ensg.u-nancy.fr> writes: +@email{cognot@@ensg.u-nancy.fr, Richard Cognot} writes: @quotation I had a few problems with 10.10. Apparently, some of them were solved by @@ -2037,9 +2116,9 @@ @end quotation @node Q2.1.14, Q2.1.15, Q2.1.13, Installation -@section @kbd{C-g} doesn't work for me. Is it broken? - -Ben Wing <ben@@666.com> writes: +@unnumberedsubsec Q2.1.14: @kbd{C-g} doesn't work for me. Is it broken? + +@email{ben@@666.com, Ben Wing} writes: @quotation @kbd{C-g} does work for most people in most circumstances. If it @@ -2058,7 +2137,7 @@ buffer. If @kbd{C-g} doesn't interrupt, then you're seeing #2. @end quotation -Morten Welinder <terra@@diku.dk> writes: +@email{terra@@diku.dk, Morten Welinder} writes: @quotation On some (but @emph{not} all) machines a hung XEmacs can be revived by @@ -2070,7 +2149,7 @@ @end quotation @node Q2.1.15, Q2.1.16, Q2.1.14, Installation -@section How to Debug an XEmacs problem with a debugger +@unnumberedsubsec Q2.1.15: How to Debug an XEmacs problem with a debugger If XEmacs does crash on you, one of the most productive things you can do to help get the bug fixed is to poke around a bit with the debugger. @@ -2080,11 +2159,11 @@ @item First of all, if the crash is at all reproducible, consider very strongly recompiling your XEmacs with debugging symbols, with no -optimization, and with the configure options @samp{--debug=yes} and -@samp{--error-checking=all}. This will make your XEmacs run somewhat -slower but make it a lot more likely to catch the problem earlier -(closer to its source), and a lot easier to determine what's going on -with a debugger. +optimization, and with the configure options @samp{--debug=yes}, +@samp{--error-checking=all}, and @samp{--dynamic=no}. This will make +your XEmacs run somewhat slower but make it a lot more likely to catch +the problem earlier (closer to its source), and a lot easier to +determine what's going on with a debugger. @item If you're able to run XEmacs under a debugger and reproduce the crash @@ -2108,8 +2187,8 @@ Internally, you will probably see lots of variables that hold objects of type @code{Lisp_Object}. These are exactly what they appear to be, i.e. references to Lisp objects. Printing them out with the debugger -probably won't be too useful---you'll likely just see a number. To -decode them, do this: +probably won't be too useful---you'll just see a number. To decode +them, do this: @example call debug_print (OBJECT) @@ -2156,7 +2235,7 @@ running the XEmacs process under a debugger, the stack trace should be clean. -Curtiss <1CMC3466@@ibm.mtsac.edu> suggests upgrading to ld.so version 1.8 +@email{1CMC3466@@ibm.mtsac.edu, Curtiss} suggests upgrading to ld.so version 1.8 if dynamic linking and debugging is a problem on Linux. @item @@ -2172,7 +2251,7 @@ @item Your stack is getting trashed. Debugging this is hard; you have to do a -binary-search type of narrowing down where the crash occurs, until you +binary-search-type of narrowing down where the crash occurs, until you figure out exactly which line is causing the problem. Of course, this only works if the bug is highly reproducible. @@ -2189,27 +2268,67 @@ @item If you compiled 19.14 with @samp{--debug} (or by default in later versions), you will get a Lisp backtrace output when XEmacs crashes, so -you'll have something useful. +you'll have something useful. If you're in 19.13, you could try doing +@code{call debug_backtrace()}---sometimes this works even after a fatal +signal has been received. + @end enumerate -@item -If you compile with the newer gcc variants gcc-2.8 or egcs, you will -need gdb 4.17. At the time of writing, this has not yet been released. -Pre-releases are available at ftp://ftp.cygnus.com/private/gdb. - -@item -The above information on using @file{src/gdbinit} works for XEmacs-21.0 -and above. For older versions of XEmacs, there are different -@file{gdbinit} files provided in the @file{src} directory. Use the one -corresponding to the configure options used when building XEmacs. - @end itemize + + +Here's some more info about using gdbinit: + +Different version of @code{gdbinit} are provided for different +platforms. One of these should be installed as @file{.gdbinit} in your +home directory. If you're using XEmacs 19.14 or better, you should +install the default @code{gdbinit} in the @file{src/} directory if you +have GDB 4.14 or better. With GDB 4.13 or earlier, install +@file{gdbinit.pre-4.14}; however, this is noticeably harder to use. If +you're on a machine that uses a union type for Lisp_Objects (only the +DEC Alpha, I think), you'll have to use @code{gdbinit.union}, which is +of the pre-4.14 variety but should be easily upgradable. + +With XEmacs 19.13 and earlier, only one @code{gdbinit} is provided (I +think); it's of the pre-4.14 variety and of the union-type +variety. (Many more machines used the union type under 19.13). + +With the GDB 4.14+ gdbinit, you can print out a Lisp_Object using +@code{p1 OBJECT} (which calls @code{debug_print()}, and hence only works +if you have a running process) or @code{frob OBJECT} (which works even +on core dumps, and does its own decoding of the object, but its output +isn't always so convenient). + +With the pre-GDB 4.14 gdbinit, you have to do these steps: + +@example +print OBJECT +xtype +<then type "xcons" or "xstring" or +whatever, depending on the type> +@end example + +If the object is a record type, you'll probably have to the following +steps: + +@example +print OBJECT +xtype +xrecord +<remember what type is printed> +print OBJECT +<then type "xbuffer" or "xsymbol" or whatever> +@end example + +Of course, if you know in advance what type the object is of, you can +omit all but the last two steps. + @node Q2.1.16, Q2.1.17, Q2.1.15, Installation -@section XEmacs crashes in @code{strcat} on HP/UX 10 +@unnumberedsubsec Q2.1.16: XEmacs crashes in @code{strcat} on HP/UX 10 >From the problems database (through -<URL:http://support.mayfield.hp.com/>): +@uref{http://support.mayfield.hp.com/}): @example Problem Report: 5003302299 @@ -2219,8 +2338,8 @@ Product Name: HPUX S800 10.0X Product Vers: 9245XB.10.00 -Description: strcat(3C) may read beyond end of source string, can cause -SIGSEGV +Description: strcat(3C) may read beyond +end of source string, can cause SIGSEGV *** PROBLEM TEXT *** @@ -2229,7 +2348,7 @@ @end example @node Q2.1.17, Q2.1.18, Q2.1.16, Installation -@section @samp{Marker does not point anywhere} +@unnumberedsubsec Q2.1.17: @samp{Marker does not point anywhere} As with other errors, set @code{debug-on-error} to @code{t} to get the backtrace when the error occurs. Specifically, two problems have been @@ -2247,9 +2366,9 @@ @end enumerate @node Q2.1.18, Q2.1.19, Q2.1.17, Installation -@section 19.14 hangs on HP/UX 10.10. - -Richard Cognot <cognot@@ensg.u-nancy.fr> writes: +@unnumberedsubsec Q2.1.18: 19.14 hangs on HP/UX 10.10. + +@email{cognot@@ensg.u-nancy.fr, Richard Cognot} writes: @quotation For the record, compiling on hpux 10.10 leads to a hang in Gnus when @@ -2266,10 +2385,14 @@ works as expected. @end quotation -Richard Cognot <cognot@@ensg.u-nancy.fr> adds: +@email{cognot@@ensg.u-nancy.fr, Richard Cognot} adds: @quotation -Apparently somebody has found the reason why there is this @samp{poll: +Apparently somebody has found the reason why there is this +@iftex +@* +@end iftex +@samp{poll: interrupted...} message for each event. For some reason, libcurses reimplements a @code{select()} system call, in a highly broken fashion. The fix is to add a -lc to the link line @emph{before} the @@ -2277,7 +2400,7 @@ @end quotation -Alain Fauconnet <af@@biomath.jussieu.fr> writes: +@email{af@@biomath.jussieu.fr, Alain Fauconnet} writes: @quotation The @emph{real} solution is to @emph{not} link -lcurses in! I just @@ -2297,7 +2420,7 @@ @end quotation @node Q2.1.19, Q2.1.20, Q2.1.18, Installation -@section XEmacs does not follow the local timezone. +@unnumberedsubsec Q2.1.19: XEmacs does not follow the local timezone. When using one of the prebuilt binaries many users have observed that XEmacs uses the timezone under which it was built, but not the timezone @@ -2311,7 +2434,7 @@ Replace @code{MET} with your local timezone. @node Q2.1.20, Q2.1.21, Q2.1.19, Installation -@section @samp{Symbol's function definition is void: hkey-help-show.} +@unnumberedsubsec Q2.1.20: @samp{Symbol's function definition is void: hkey-help-show.} This is a problem with a partially loaded hyperbole. Try adding: @@ -2322,15 +2445,15 @@ where you load hyperbole and the problem should go away. @node Q2.1.21, Q2.1.22, Q2.1.20, Installation -@section Every so often the XEmacs frame freezes +@unnumberedsubsec Q2.1.21: Every so often the XEmacs frame freezes This problem has been fixed in 19.15, and was due to a not easily reproducible race condition. @node Q2.1.22, Q2.1.23, Q2.1.21, Installation -@section XEmacs seems to take a really long time to do some things - -David Moore <dmoore@@ucsd.edu> writes: +@unnumberedsubsec Q2.1.22: XEmacs seems to take a really long time to do some things + +@email{dmoore@@ucsd.edu, David Moore} writes: @quotation Two things you can do: @@ -2363,12 +2486,12 @@ @end quotation @node Q2.1.23, , Q2.1.22, Installation -@section Movemail on Linux does not work for XEmacs 19.15 and later. +@unnumberedsubsec Q2.1.23: Movemail on Linux does not work for XEmacs 19.15 and later. Movemail used to work fine in 19.14 but has stopped working in 19.15 and 20.x. I am using Linux. -SL Baur <steve@@xemacs.org> writes: +@email{steve@@xemacs.org, SL Baur} writes: @quotation Movemail on Linux used to default to using flock file locking. With @@ -2382,20 +2505,20 @@ @end quotation @node Customization, Subsystems, Installation, Top -@chapter Customization and Options +@unnumbered 3 Customization and Options This is part 3 of the XEmacs Frequently Asked Questions list. This section is devoted to Customization and screen settings. @menu Customization---Emacs Lisp and @file{.emacs}: -* Q3.0.1:: What version of Emacs am I running? +* Q3.0.1:: What version of Emacs am I running? * Q3.0.2:: How do I evaluate Elisp expressions? * Q3.0.3:: @code{(setq tab-width 6)} behaves oddly. * Q3.0.4:: How can I add directories to the @code{load-path}? * Q3.0.5:: How to check if a lisp function is defined? * Q3.0.6:: Can I force the output of @code{(face-list)} to a buffer? -* Q3.0.7:: Font selections don't get saved after @code{Save Options}. +* Q3.0.7:: Font selections don't get saved after @code{Save Options}. * Q3.0.8:: How do I make a single minibuffer frame? * Q3.0.9:: What is @code{Customize}? @@ -2407,13 +2530,13 @@ * Q3.1.5:: How can I get the icon to just say @samp{XEmacs}? * Q3.1.6:: How can I have the window title area display the full path? * Q3.1.7:: @samp{xemacs -name junk} doesn't work? -* Q3.1.8:: @samp{-iconic} doesn't work. +* Q3.1.8:: @samp{-iconic} it doesn't work. Textual Fonts & Colors: * Q3.2.1:: How can I set color options from @file{.emacs}? * Q3.2.2:: How do I set the text, menu and modeline fonts? * Q3.2.3:: How can I set the colors when highlighting a region? -* Q3.2.4:: How can I limit color map usage? +* Q3.2.4:: How can I limit color map usage? * Q3.2.5:: My tty supports color, but XEmacs doesn't use them. The Modeline: @@ -2424,7 +2547,7 @@ * Q3.3.5:: How can one change the modeline color based on the mode used? 3.4 Multiple Device Support: -* Q3.4.1:: How do I open a frame on another screen of my multi-headed display? +* Q3.4.1:: How do I open a frame on another screen of my multi-headed display? * Q3.4.2:: Can I really connect to a running XEmacs after calling up over a modem? How? 3.5 The Keyboard: @@ -2433,7 +2556,7 @@ * Q3.5.3:: How do I bind C-. and C-; to scroll one line up and down? * Q3.5.4:: Globally binding @kbd{Delete}? * Q3.5.5:: Scrolling one line at a time. -* Q3.5.6:: How to map @kbd{Help} key alone on Sun type4 keyboard? +* Q3.5.6:: How to map @kbd{Help} key alone on Sun type4 keyboard? * Q3.5.7:: How can you type in special characters in XEmacs? * Q3.5.8:: Why does @code{(global-set-key [delete-forward] 'delete-char)} complain? * Q3.5.9:: How do I make the Delete key delete forward? @@ -2468,7 +2591,7 @@ * Q3.9.4:: How can I get automatic horizontal scrolling? Text Selections: -* Q3.10.1:: How can I turn off or change highlighted selections? +* Q3.10.1:: How can I turn off or change highlighted selections? * Q3.10.2:: How do I get that typing on an active region removes it? * Q3.10.3:: Can I turn off the highlight during isearch? * Q3.10.4:: How do I turn off highlighting after @kbd{C-x C-p} (mark-page)? @@ -2476,7 +2599,8 @@ @end menu @node Q3.0.1, Q3.0.2, Customization, Customization -@section What version of Emacs am I running? +@unnumberedsec 3.0: Customization -- Emacs Lisp and .emacs +@unnumberedsubsec Q3.0.1: What version of Emacs am I running? How can @file{.emacs} determine which of the family of Emacsen I am using? @@ -2493,7 +2617,7 @@ @end lisp @node Q3.0.2, Q3.0.3, Q3.0.1, Customization -@section How can I evaluate Emacs-Lisp expressions? +@unnumberedsubsec Q3.0.2: How can I evaluate Emacs-Lisp expressions? I know I can evaluate Elisp expressions from @code{*scratch*} buffer with @kbd{C-j} after the expression. How do I do it from another @@ -2505,7 +2629,7 @@ this is the case, upgrade your XEmacs. @node Q3.0.3, Q3.0.4, Q3.0.2, Customization -@section @code{(setq tab-width 6)} behaves oddly. +@unnumberedsubsec Q3.0.3: @code{(setq tab-width 6)} behaves oddly. If you put @code{(setq tab-width 6)} in your @file{.emacs} file it does not work! Is there a reason for this? If you do it at the EVAL prompt @@ -2515,7 +2639,7 @@ all-buffer-local. @node Q3.0.4, Q3.0.5, Q3.0.3, Customization -@section How can I add directories to the @code{load-path}? +@unnumberedsubsec Q3.0.4: How can I add directories to the @code{load-path}? Here are two ways to do that, one that puts your directories at the front of the load-path, the other at the end: @@ -2531,7 +2655,7 @@ (setq load-path (nconc load-path '("foo" "bar"))) @end lisp -keith (k.p.) hanlan <keithh@@nortel.ca> writes: +@email{keithh@@nortel.ca, keith (k.p.) hanlan} writes: @quotation To add directories using Unix shell metacharacters use @@ -2543,7 +2667,7 @@ @end quotation @node Q3.0.5, Q3.0.6, Q3.0.4, Customization -@section How to check if a lisp function is defined? +@unnumberedsubsec Q3.0.5: How to check if a lisp function is defined? Use the following elisp: @@ -2555,12 +2679,12 @@ variables. Instead, use feature-tests, such as @code{featurep}, @code{boundp}, -@code{fboundp}, or even simple behavioral tests, eg.: +@code{fboundp}, or even simple behavioural tests, eg.: @lisp -(defvar foo-old-losing-code-p +(defvar foo-old-losing-code-p (condition-case nil (progn (losing-code t) nil) - (wrong-number-of-arguments t))) + (wrong-number-of-arguments t))) @end lisp There is an incredible amount of broken code out there which could work @@ -2568,7 +2692,7 @@ trying to divine its environment from the value of one variable. @node Q3.0.6, Q3.0.7, Q3.0.5, Customization -@section Can I force the output of @code{(face-list)} to a buffer? +@unnumberedsubsec Q3.0.6: Can I force the output of @code{(face-list)} to a buffer? It would be good having it in a buffer, as the output of @code{(face-list)} is too wide to fit to a minibuffer. @@ -2581,11 +2705,11 @@ buffer. @node Q3.0.7, Q3.0.8, Q3.0.6, Customization -@section Font selections in don't get saved after @code{Save Options}. +@unnumberedsubsec Q3.0.7: Font selections in don't get saved after @code{Save Options}. For XEmacs 19.14 and previous: -John Mann <mannj@@ll.mit.edu> writes: +@email{mannj@@ll.mit.edu, John Mann} writes: @quotation You have to go to Options->Menubar Appearance and unselect @@ -2596,31 +2720,31 @@ For XEmacs 19.15 and later: -Implement the above as well as set the following in your @file{.emacs} +Implement the above as well as set the following in your @file{.emacs} @lisp (setq options-save-faces t) @end lisp @node Q3.0.8, Q3.0.9, Q3.0.7, Customization -@section How do I get a single minibuffer frame? - -Vin Shelton <acs@@acm.org> writes: +@unnumberedsubsec Q3.0.8: How do I get a single minibuffer frame? + +@email{acs@@acm.org, Vin Shelton} writes: @lisp (setq initial-frame-plist '(minibuffer nil)) (setq default-frame-plist '(minibuffer nil)) (setq default-minibuffer-frame (make-frame - '(minibuffer only - width 86 - height 1 - menubar-visible-p nil - default-toolbar-visible-p nil - name "minibuffer" - top -2 - left -2 - has-modeline-p nil))) + '(minibuffer only + width 86 + height 1 + menubar-visible-p nil + default-toolbar-visible-p nil + name "minibuffer" + top -2 + left -2 + has-modeline-p nil))) (frame-notice-user-settings) @end lisp @@ -2629,7 +2753,7 @@ make it difficult or inconvenient to use. @node Q3.0.9, Q3.1.1, Q3.0.8, Customization -@section What is @code{Customize}? +@unnumberedsubsec Q3.0.9: What is @code{Customize}? Starting with XEmacs 20.2 there is new system 'Customize' for customizing XEmacs options. @@ -2643,7 +2767,8 @@ Try it out with @kbd{M-x customize-browse} @node Q3.1.1, Q3.1.2, Q3.0.9, Customization -@section Where is a list of X resources? +@unnumberedsec 3.1: X Window System & Resources +@unnumberedsubsec Q3.1.1: Where is a list of X resources? Search through the @file{NEWS} file for @samp{X Resources}. A fairly comprehensive list is given after it. @@ -2657,7 +2782,7 @@ you use GNU Emacs under X11 as well. @node Q3.1.2, Q3.1.3, Q3.1.1, Customization -@section How can I detect a color display? +@unnumberedsubsec Q3.1.2: How can I detect a color display? You can test the return value of the function @code{(device-class)}, as in: @@ -2671,11 +2796,15 @@ @end lisp @node Q3.1.3, Q3.1.4, Q3.1.2, Customization -@section @code{(set-screen-width)} worked in 19.6, but not in 19.13? +@unnumberedsubsec Q3.1.3: @code{(set-screen-width)} worked in 19.6, but not in 19.13? In Lucid Emacs 19.6 I did @code{(set-screen-width @var{characters})} and @code{(set-screen-height @var{lines})} in my @file{.emacs} instead of -specifying @code{Emacs*EmacsScreen.geometry} in my @file{.Xdefaults} but +specifying @code{Emacs*EmacsScreen.geometry} in my +@iftex +@* +@end iftex +@file{.Xdefaults} but this does not work in XEmacs 19.13. These two functions now take frame arguments: @@ -2686,7 +2815,7 @@ @end lisp @node Q3.1.4, Q3.1.5, Q3.1.3, Customization -@section Specifying @code{Emacs*EmacsScreen.geometry} in @file{.emacs} does not work in 19.15? +@unnumberedsubsec Q3.1.4: Specifying @code{Emacs*EmacsScreen.geometry} in @file{.emacs} does not work in 19.15? In XEmacs 19.11 I specified @code{Emacs*EmacsScreen.geometry} in my @file{.emacs} but this does not work in XEmacs 19.15. @@ -2701,7 +2830,7 @@ @end example @node Q3.1.5, Q3.1.6, Q3.1.4, Customization -@section How can I get the icon to just say @samp{XEmacs}? +@unnumberedsubsec Q3.1.5: How can I get the icon to just say @samp{XEmacs}? I'd like the icon to just say @samp{XEmacs}, and not include the name of the current file in it. @@ -2713,7 +2842,7 @@ @end lisp @node Q3.1.6, Q3.1.7, Q3.1.5, Customization -@section How can I have the window title area display the full path? +@unnumberedsubsec Q3.1.6: How can I have the window title area display the full path? I'd like to have the window title area display the full directory/name of the current buffer file and not just the name. @@ -2728,13 +2857,14 @@ @lisp (setq frame-title-format - '("%S: " (buffer-file-name "%f" (dired-directory dired-directory "%b")))) + '("%S: " (buffer-file-name "%f" + (dired-directory dired-directory "%b")))) @end lisp That is, use the file name, or the dired-directory, or the buffer name. @node Q3.1.7, Q3.1.8, Q3.1.6, Customization -@section @samp{xemacs -name junk} doesn't work? +@unnumberedsubsec Q3.1.7: @samp{xemacs -name junk} doesn't work? When I run @samp{xterm -name junk}, I get an xterm whose class name according to xprop, is @samp{junk}. This is the way it's supposed to @@ -2785,13 +2915,13 @@ @end lisp @node Q3.1.8, Q3.2.1, Q3.1.7, Customization -@section @samp{-iconic} doesn't work. +@unnumberedsubsec Q3.1.8: @samp{-iconic} doesn't work. When I start up XEmacs using @samp{-iconic} it doesn't work right. Using @samp{-unmapped} on the command line, and setting the @code{initiallyUnmapped} X Resource don't seem to help much either... -Ben Wing <ben@@666.com> writes: +@email{ben@@666.com, Ben Wing} writes: @quotation Ugh, this stuff is such an incredible mess that I've about given up @@ -2800,7 +2930,8 @@ @end quotation @node Q3.2.1, Q3.2.2, Q3.1.8, Customization -@section How can I set color options from @file{.emacs}? +@unnumberedsec 3.2: Textual Fonts & Colors +@unnumberedsubsec Q3.2.1: How can I set color options from @file{.emacs}? How can I set the most commonly used color options from my @file{.emacs} instead of from my @file{.Xdefaults}? @@ -2808,28 +2939,31 @@ Like this: @lisp -(set-face-background 'default "bisque") ; frame background -(set-face-foreground 'default "black") ; normal text -(set-face-background 'zmacs-region "red") ; When selecting w/ - ; mouse +(set-face-background 'default "bisque") ; frame background +(set-face-foreground 'default "black") ; normal text +(set-face-background 'zmacs-region "red") ; When selecting w/ + ; mouse (set-face-foreground 'zmacs-region "yellow") (set-face-font 'default "*courier-bold-r*120-100-100*") -(set-face-background 'highlight "blue") ; Ie when selecting buffers +(set-face-background 'highlight "blue") ; Ie when selecting + ; buffers (set-face-foreground 'highlight "yellow") -(set-face-background 'modeline "blue") ; Line at bottom of buffer +(set-face-background 'modeline "blue") ; Line at bottom + ; of buffer (set-face-foreground 'modeline "white") (set-face-font 'modeline "*bold-r-normal*140-100-100*") -(set-face-background 'isearch "yellow") ; When highlighting while - ; searching +(set-face-background 'isearch "yellow") ; When highlighting + ; while searching (set-face-foreground 'isearch "red") -(setq x-pointer-foreground-color "black") ; Adds to bg color, - ; so keep black -(setq x-pointer-background-color "blue") ; This is color you really - ; want ptr/crsr +(setq x-pointer-foreground-color "black") ; Adds to bg color, + ; so keep black +(setq x-pointer-background-color "blue") ; This is color + ; you really + ; want ptr/crsr @end lisp @node Q3.2.2, Q3.2.3, Q3.2.1, Customization -@section How do I set the text, menu and modeline fonts? +@unnumberedsubsec Q3.2.2: How do I set the text, menu and modeline fonts? Note that you should use @samp{Emacs.} and not @samp{Emacs*} when setting face values. @@ -2837,7 +2971,7 @@ In @file{.Xdefaults}: @example -Emacs.default.attributeFont: -*-*-medium-r-*-*-*-120-*-*-m-*-*-* +Emacs.default.attributeFont: -*-*-medium-r-*-*-*-120-*-*-m-*-*-* Emacs*menubar*font: fixed Emacs.modeline.attributeFont: fixed @end example @@ -2850,7 +2984,7 @@ instead of @code{font}. @node Q3.2.3, Q3.2.4, Q3.2.2, Customization -@section How can I set the colors when highlighting a region? +@unnumberedsubsec Q3.2.3: How can I set the colors when highlighting a region? How can I set the background/foreground colors when highlighting a region? @@ -2866,12 +3000,12 @@ or in your @file{.emacs}: @lisp -(set-face-background 'zmacs-region "red") +(set-face-background 'zmacs-region "red") (set-face-foreground 'zmacs-region "yellow") @end lisp @node Q3.2.4, Q3.2.5, Q3.2.3, Customization -@section How can I limit color map usage? +@unnumberedsubsec Q3.2.4: How can I limit color map usage? I'm using Netscape (or another color grabber like XEmacs); is there anyway to limit the number of available colors in the color map? @@ -2891,7 +3025,7 @@ the colormap is full, so it's O.K. now to start Netscape first. @node Q3.2.5, Q3.3.1, Q3.2.4, Customization -@section My tty supports color, but XEmacs doesn't use them. +@unnumberedsubsec Q3.2.5: My tty supports color, but XEmacs doesn't use them. XEmacs tries to automatically determine whether your tty supports color, but sometimes guesses wrong. In that case, you can make XEmacs Do The @@ -2903,7 +3037,7 @@ @end lisp @node Q3.3.1, Q3.3.2, Q3.2.5, Customization -@section How can I make the modeline go away? +@unnumberedsubsec Q3.3.1: How can I make the modeline go away? @lisp (set-specifier has-modeline-p nil) @@ -2914,7 +3048,7 @@ try the new version out. @node Q3.3.2, Q3.3.3, Q3.3.1, Customization -@section How do you have XEmacs display the line number in the modeline? +@unnumberedsubsec Q3.3.2: How do you have XEmacs display the line number in the modeline? Add the following line to your @file{.emacs} file to display the line number: @@ -2930,14 +3064,20 @@ @end lisp Or select from the @code{Options} menu - @code{Customize->Emacs->Editing->Basics->Line Number Mode} +@iftex +@* +@end iftex +@code{Customize->Emacs->Editing->Basics->Line Number Mode} and/or - @code{Customize->Emacs->Editing->Basics->Column Number Mode} +@iftex +@* +@end iftex +@code{Customize->Emacs->Editing->Basics->Column Number Mode} Or type @kbd{M-x customize RET editing-basics RET}. @node Q3.3.3, Q3.3.4, Q3.3.2, Customization -@section How do I get XEmacs to put the time of day on the modeline? +@unnumberedsubsec Q3.3.3: How do I get XEmacs to put the time of day on the modeline? Add the following line to your @file{.emacs} file to display the time: @@ -2949,7 +3089,7 @@ See @code{Customize} from the @code{Options} menu for customization. @node Q3.3.4, Q3.3.5, Q3.3.3, Customization -@section How do I turn off current chapter from AUC TeX modeline? +@unnumberedsubsec Q3.3.4: How do I turn off current chapter from AUC TeX modeline? With AUC TeX, fast typing is hard because the current chapter, section etc. are given in the modeline. How can I turn this off? @@ -2965,10 +3105,11 @@ mode: @lisp -(add-hook 'TeX-mode-hook '(lambda () (setq fume-display-in-modeline-p nil))) +(add-hook 'TeX-mode-hook + '(lambda () (setq fume-display-in-modeline-p nil))) @end lisp -David Hughes <dhughes@@origin-at.co.uk> writes: +@email{dhughes@@origin-at.co.uk, David Hughes} writes: @quotation If you have 19.14 or later, try this instead; you'll still get the @@ -2983,12 +3124,12 @@ @end quotation @node Q3.3.5, Q3.4.1, Q3.3.4, Customization -@section How can one change the modeline color based on the mode used? +@unnumberedsubsec Q3.3.5: How can one change the modeline color based on the mode used? You can use something like the following: @lisp -(add-hook 'lisp-mode-hook +(add-hook 'lisp-mode-hook (lambda () (set-face-background 'modeline "red" (current-buffer)))) @end lisp @@ -3026,7 +3167,8 @@ @code{modeline-mousable-minor-mode}, which you may want to customize. @node Q3.4.1, Q3.4.2, Q3.3.5, Customization -@section How do I open a frame on another screen of my multi-headed display? +@unnumberedsec 3.4: Multiple Device Support +@unnumberedsubsec Q3.4.1: How do I open a frame on another screen of my multi-headed display? The support for this was revamped for 19.14. Use the command @kbd{M-x make-frame-on-display}. This command is also on the File menu @@ -3037,7 +3179,7 @@ TTY devices should be left to @code{gnuclient}, though. @node Q3.4.2, Q3.5.1, Q3.4.1, Customization -@section Can I really connect to a running XEmacs after calling up over a modem? How? +@unnumberedsubsec Q3.4.2: Can I really connect to a running XEmacs after calling up over a modem? How? If you're not running at least XEmacs 19.14, you can't. Otherwise check out the @code{gnuattach} program supplied with XEmacs. Starting with @@ -3047,7 +3189,8 @@ Also @xref{Q5.0.12}. @node Q3.5.1, Q3.5.2, Q3.4.2, Customization -@section How can I bind complex functions (or macros) to keys? +@unnumberedsec 3.5: The Keyboard +@unnumberedsubsec Q3.5.1: How can I bind complex functions (or macros) to keys? As an example, say you want the @kbd{paste} key on a Sun keyboard to insert the current Primary X selection at point. You can accomplish this @@ -3066,7 +3209,7 @@ @lisp (global-set-key [f18] - (lambda () (interactive) (x-insert-selection t nil))) + (lambda () (interactive) (x-insert-selection t nil))) @end lisp This binds the f18 key to a @dfn{generic} functional object. The @@ -3077,9 +3220,9 @@ @lisp (global-set-key [(control ?.)] - (lambda () (interactive) (scroll-up 1))) -(global-set-key [(control ?;)] - (lambda () (interactive) (scroll-up -1))) + (lambda () (interactive) (scroll-up 1))) +(global-set-key [(control ? ;)] + (lambda () (interactive) (scroll-up -1))) @end lisp This is fine if you only need a few functions within the lambda body. @@ -3087,7 +3230,7 @@ question 3.5.3 (@xref{Q3.5.3}). @node Q3.5.2, Q3.5.3, Q3.5.1, Customization -@section How can I stop down-arrow from adding empty lines to the bottom of my buffers? +@unnumberedsubsec Q3.5.2: How can I stop down-arrow from adding empty lines to the bottom of my buffers? Add the following line to your @file{.emacs} file: @@ -3098,10 +3241,10 @@ This has been the default setting in XEmacs for some time. @node Q3.5.3, Q3.5.4, Q3.5.2, Customization -@section How do I bind C-. and C-; to scroll one line up and down? - -Add the following (Thanks to Richard Mlynarik <mly@@adoc.xerox.com> and -Wayne Newberry <wayne@@zen.cac.stratus.com>) to @file{.emacs}: +@unnumberedsubsec Q3.5.3: How do I bind C-. and C-; to scroll one line up and down? + +Add the following (Thanks to @email{mly@@adoc.xerox.com, Richard Mlynarik} and +@email{wayne@@zen.cac.stratus.com, Wayne Newberry}) to @file{.emacs}: @lisp (defun scroll-up-one-line () @@ -3112,8 +3255,8 @@ (interactive) (scroll-down 1)) -(global-set-key [(control ?.)] 'scroll-up-one-line) ; C-. -(global-set-key [(control ?;)] 'scroll-down-one-line) ; C-; +(global-set-key [(control ?.)] 'scroll-up-one-line) ; C-. +(global-set-key [(control ? ;)] 'scroll-down-one-line) ; C-; @end lisp The key point is that you can only bind simple functions to keys; you @@ -3121,7 +3264,7 @@ (@xref{Q3.5.1} for a better answer). @node Q3.5.4, Q3.5.5, Q3.5.3, Customization -@section Globally binding @kbd{Delete}? +@unnumberedsubsec Q3.5.4: Globally binding @kbd{Delete}? I cannot manage to globally bind my @kbd{Delete} key to something other than the default. How does one do this? @@ -3146,7 +3289,7 @@ Also @xref{Q3.5.10}. @node Q3.5.5, Q3.5.6, Q3.5.4, Customization -@section Scrolling one line at a time. +@unnumberedsubsec Q3.5.5: Scrolling one line at a time. Can the cursor keys scroll the screen a line at a time, rather than the default half page jump? I tend it to find it disorienting. @@ -3181,18 +3324,18 @@ @kbd{M-x customize RET windows RET}. @node Q3.5.6, Q3.5.7, Q3.5.5, Customization -@section How to map @kbd{Help} key alone on Sun type4 keyboard? +@unnumberedsubsec Q3.5.6: How to map @kbd{Help} key alone on Sun type4 keyboard? The following works in GNU Emacs 19: @lisp -(global-set-key [help] 'help-command) ;; Help +(global-set-key [help] 'help-command);; Help @end lisp The following works in XEmacs 19.15 with the addition of shift: @lisp -(global-set-key [(shift help)] 'help-command) ;; Help +(global-set-key [(shift help)] 'help-command);; Help @end lisp But it doesn't work alone. This is in the file @file{PROBLEMS} which @@ -3200,14 +3343,18 @@ @kbd{help} key when running OLWM}. OLWM grabs the @kbd{help} key, and retransmits it to the appropriate -client using @code{XSendEvent}. Allowing Emacs to react to synthetic +client using +@iftex +@* +@end iftex +@code{XSendEvent}. Allowing Emacs to react to synthetic events is a security hole, so this is turned off by default. You can enable it by setting the variable @code{x-allow-sendevents} to t. You can also cause fix this by telling OLWM to not grab the help key, with the null binding @code{OpenWindows.KeyboardCommand.Help:}. @node Q3.5.7, Q3.5.8, Q3.5.6, Customization -@section How can you type in special characters in XEmacs? +@unnumberedsubsec Q3.5.7: How can you type in special characters in XEmacs? One way is to use the package @code{x-compose}. Then you can use sequences like @kbd{Compose " a} to get ä, etc. @@ -3217,7 +3364,7 @@ ä, etc. @node Q3.5.8, Q3.5.9, Q3.5.7, Customization -@section Why does @code{(global-set-key [delete-forward] 'delete-char)} complain? +@unnumberedsubsec Q3.5.8: Why does @code{(global-set-key [delete-forward] 'delete-char)} complain? Why does @code{(define-key global-map [ delete-forward ] 'delete-char)} complain of not being able to bind an unknown key? @@ -3241,7 +3388,7 @@ This bug has been fixed in 19.14. @node Q3.5.9, Q3.5.10, Q3.5.8, Customization -@section How do I make the Delete key delete forward? +@unnumberedsubsec Q3.5.9: How do I make the Delete key delete forward? With XEmacs-20.2 use the @code{delbs} package: @@ -3262,14 +3409,14 @@ Also @xref{Q3.5.4}. @node Q3.5.10, Q3.6.1, Q3.5.9, Customization -@section Can I turn on @dfn{sticky} modifier keys? +@unnumberedsubsec Q3.5.10: Can I turn on @dfn{sticky} modifier keys? Yes, with @code{(setq modifier-keys-are-sticky t)}. This will give the effect of being able to press and release Shift and have the next character typed come out in upper case. This will affect all the other modifier keys like Control and Meta as well. -Ben Wing <ben@@666.com> writes: +@email{ben@@666.com, Ben Wing} writes: @quotation One thing about the sticky modifiers is that if you move the mouse out @@ -3277,7 +3424,8 @@ @end quotation @node Q3.6.1, Q3.6.2, Q3.5.10, Customization -@section Is there a way to make the bar cursor thicker? +@unnumberedsec 3.6: The Cursor +@unnumberedsubsec Q3.6.1: Is there a way to make the bar cursor thicker? I'd like to have the bar cursor a little thicker, as I tend to "lose" it often. @@ -3306,7 +3454,7 @@ @end example @node Q3.6.2, Q3.6.3, Q3.6.1, Customization -@section Is there a way to get back the block cursor? +@unnumberedsubsec Q3.6.2: Is there a way to get back the block cursor? @lisp (setq bar-cursor nil) @@ -3318,7 +3466,7 @@ @kbd{M-x customize RET display RET}. @node Q3.6.3, Q3.7.1, Q3.6.2, Customization -@section Can I make the cursor blink? +@unnumberedsubsec Q3.6.3: Can I make the cursor blink? If you are running a version of XEmacs older than 19.14, no. Otherwise you can do the following: @@ -3332,7 +3480,8 @@ => Frame Appearance => Blinking Cursor}. Remember to save options. @node Q3.7.1, Q3.7.2, Q3.6.3, Customization -@section How can I turn off Mouse pasting? +@unnumberedsec 3.7: The Mouse and Highlighting +@unnumberedsubsec Q3.7.1: How can I turn off Mouse pasting? I keep hitting the middle mouse button by accident and getting stuff pasted into my buffer so how can I turn this off? @@ -3352,7 +3501,7 @@ @end lisp @node Q3.7.2, Q3.7.3, Q3.7.1, Customization -@section How do I set control/meta/etc modifiers on mouse buttons? +@unnumberedsubsec Q3.7.2: How do I set control/meta/etc modifiers on mouse buttons? Use, for instance, @code{[(meta button1)]}. For example, here is a common setting for Common Lisp programmers who use the bundled @code{ilisp} @@ -3368,7 +3517,7 @@ @end lisp @node Q3.7.3, Q3.7.4, Q3.7.2, Customization -@section Clicking the left button does not do anything in buffer list. +@unnumberedsubsec Q3.7.3: Clicking the left button does not do anything in buffer list. I do @kbd{C-x C-b} to get a list of buffers and the entries get highlighted when I move the mouse over them but clicking the left mouse @@ -3377,7 +3526,7 @@ Use the middle mouse button. @node Q3.7.4, Q3.7.5, Q3.7.3, Customization -@section How can I get a list of buffers when I hit mouse button 3? +@unnumberedsubsec Q3.7.4: How can I get a list of buffers when I hit mouse button 3? The following code will replace the default popup on button3: @@ -3386,7 +3535,7 @@ @end lisp @node Q3.7.5, Q3.7.6, Q3.7.4, Customization -@section Why does cut-and-paste not work between XEmacs and a cmdtool? +@unnumberedsubsec Q3.7.5: Why does cut-and-paste not work between XEmacs and a cmdtool? We don't know. It's a bug. There does seem to be a work-around, however. Try running xclipboard first. It appears to fix the problem @@ -3394,7 +3543,7 @@ haven't yet verified that). @node Q3.7.6, Q3.7.7, Q3.7.5, Customization -@section How I can set XEmacs up so that it pastes where the text cursor is? +@unnumberedsubsec Q3.7.6: How I can set XEmacs up so that it pastes where the text cursor is? By default XEmacs pastes X selections where the mouse pointer is. How do I disable this? @@ -3414,7 +3563,7 @@ @kbd{M-x customize RET mouse RET}. @node Q3.7.7, Q3.7.8, Q3.7.6, Customization -@section How do I select a rectangular region? +@unnumberedsubsec Q3.7.7: How do I select a rectangular region? Just select the region normally, then use the rectangle commands (e.g. @code{kill-rectangle} on it. The region does not highlight as a @@ -3444,7 +3593,7 @@ @end example @node Q3.7.8, Q3.8.1, Q3.7.7, Customization -@section Why does @kbd{M-w} take so long? +@unnumberedsubsec Q3.7.8: Why does @kbd{M-w} take so long? It actually doesn't. It leaves the region visible for a second so that you can see what area is being yanked. If you start working, though, it @@ -3452,7 +3601,8 @@ delay for a second if you let it. @node Q3.8.1, Q3.8.2, Q3.7.8, Customization -@section How do I get rid of the menu (or menubar)? +@unnumberedsec 3.8: The Menubar and Toolbar +@unnumberedsubsec Q3.8.1: How do I get rid of the menu (or menubar)? If you are running XEmacs 19.13 and earlier, add this command to your @file{.emacs}. @@ -3468,7 +3618,7 @@ @end lisp @node Q3.8.2, Q3.8.3, Q3.8.1, Customization -@section Can I customize the basic menubar? +@unnumberedsubsec Q3.8.2: Can I customize the basic menubar? For an extensive menubar, add this line to your @file{.emacs}: @@ -3482,7 +3632,7 @@ directory. @node Q3.8.3, Q3.8.4, Q3.8.2, Customization -@section How do I control how many buffers are listed in the menu @code{Buffers List}? +@unnumberedsubsec Q3.8.3: How do I control how many buffers are listed in the menu @code{Buffers List}? Add the following to your @file{.emacs} (suit to fit): @@ -3498,7 +3648,7 @@ type @kbd{M-x customize RET buffers-menu RET}. @node Q3.8.4, Q3.8.5, Q3.8.3, Customization -@section Resources like @code{Emacs*menubar*font} are not working? +@unnumberedsubsec Q3.8.4: Resources like @code{Emacs*menubar*font} are not working? I am trying to use a resource like @code{Emacs*menubar*font} to set the font of the menubar but it's not working. @@ -3527,7 +3677,7 @@ even though the latter is more specific. @node Q3.8.5, Q3.9.1, Q3.8.4, Customization -@section How can I bind a key to a function to toggle the toolbar? +@unnumberedsubsec Q3.8.5: How can I bind a key to a function to toggle the toolbar? Try something like: @@ -3544,11 +3694,12 @@ may need to resize the frame before XEmacs completely realizes the toolbar is really gone. -Thanks to Martin Buchholz <martin@@xemacs.org> for the correct +Thanks to @email{martin@@xemacs.org, Martin Buchholz} for the correct code. @node Q3.9.1, Q3.9.2, Q3.8.5, Customization -@section How can I disable the scrollbar? +@unnumberedsec 3.9: Scrollbars +@unnumberedsubsec Q3.9.1: How can I disable the scrollbar? To disable them for all frames, add the following line to your @file{.Xdefaults}: @@ -3557,7 +3708,7 @@ Emacs.scrollBarWidth: 0 @end example -Or select from the @code{Options} menu @code{Frame Appearance->Scrollbars}. +Or select from the @code{Options} menu @code{Frame Appearance->Scrolbars}. Remember to save options. To turn the scrollbar off on a per-frame basis, use the following @@ -3582,7 +3733,7 @@ @end lisp @node Q3.9.2, Q3.9.3, Q3.9.1, Customization -@section How can one use resources to change scrollbar colors? +@unnumberedsubsec Q3.9.2: How can one use resources to change scrollbar colors? Here's a recap of how to use resources to change your scrollbar colors: @@ -3601,7 +3752,7 @@ Note the capitalization of @code{Scrollbar} for the Athena widget. @node Q3.9.3, Q3.9.4, Q3.9.2, Customization -@section Moving the scrollbar can move the point; can I disable this? +@unnumberedsubsec Q3.9.3: Moving the scrollbar can move the point; can I disable this? When I move the scrollbar in an XEmacs window, it moves the point as well, which should not be the default behavior. Is this a bug or a @@ -3615,7 +3766,7 @@ This cannot be changed. @node Q3.9.4, Q3.10.1, Q3.9.3, Customization -@section How can I get automatic horizontal scrolling? +@unnumberedsubsec Q3.9.4: How can I get automatic horizontal scrolling? By the same token, how can I turn it off in specific modes? @@ -3643,7 +3794,8 @@ Automatic horizontal scrolling is now standard, starting with 19.14. @node Q3.10.1, Q3.10.2, Q3.9.4, Customization -@section How can I turn off or change highlighted selections? +@unnumberedsec Text Selections +@unnumberedsubsec Q3.10.1: How can I turn off or change highlighted selections? The @code{zmacs} mode allows for what some might call gratuitous highlighting for selected regions (either by setting mark or by using @@ -3662,7 +3814,7 @@ the menubar. @node Q3.10.2, Q3.10.3, Q3.10.1, Customization -@section How do I get that typing on an active region removes it? +@unnumberedsubsec Q3.10.2: How do I get that typing on an active region removes it? I want to change things so that if I select some text and start typing, the typed text replaces the selected text, similar to Motif. @@ -3681,7 +3833,7 @@ Note that this will work with both Backspace and Delete. @node Q3.10.3, Q3.10.4, Q3.10.2, Customization -@section Can I turn off the highlight during isearch? +@unnumberedsubsec Q3.10.3: Can I turn off the highlight during isearch? I do not like my text highlighted while I am doing isearch as I am not able to see what's underneath. How do I turn it off? @@ -3700,7 +3852,7 @@ solution consists of customizing the @code{isearch} face. @node Q3.10.4, Q3.10.5, Q3.10.3, Customization -@section How do I turn off highlighting after @kbd{C-x C-p} (mark-page)? +@unnumberedsubsec Q3.10.4: How do I turn off highlighting after @kbd{C-x C-p} (mark-page)? Put this in your @code{.emacs}: @@ -3713,7 +3865,7 @@ Also @xref{Q3.10.1}. @node Q3.10.5, , Q3.10.4, Customization -@section The region disappears when I hit the end of buffer while scrolling. +@unnumberedsubsec Q3.10.5: The region disappears when I hit the end of buffer while scrolling. This has been fixed by default starting with XEmacs-20.3. @@ -3740,11 +3892,11 @@ ad-do-it))) @end lisp -Thanks to T. V. Raman <raman@@adobe.com> for assistance in deriving this +Thanks to @email{raman@@adobe.com, T. V. Raman} for assistance in deriving this answer. @node Subsystems, Miscellaneous, Customization, Top -@chapter Major Subsystems +@unnumbered 4 Major Subsystems This is part 4 of the XEmacs Frequently Asked Questions list. This section is devoted to major XEmacs subsystems. @@ -3770,7 +3922,7 @@ * Q4.1.3:: Is it true that W3 supports style sheets and tables? Reading Netnews and Mail with Gnus: -* Q4.2.1:: GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus,argh! +* Q4.2.1:: GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus,argh! * Q4.2.2:: [This question intentionally left blank] * Q4.2.3:: How do I make Gnus stay within a single frame? * Q4.2.4:: How do I customize the From: line? @@ -3783,7 +3935,7 @@ * Q4.3.5:: Where do I find pstogif (required by tm)? Sparcworks, EOS, and WorkShop: -* Q4.4.1:: What is SPARCworks, EOS, and WorkShop +* Q4.4.1:: What is SPARCworks, EOS, and WorkShop Energize: * Q4.5.1:: What is/was Energize? @@ -3800,7 +3952,8 @@ @end menu @node Q4.0.1, Q4.0.2, Subsystems, Subsystems -@section How do I set up VM to retrieve mail from a remote site using POP? +@unnumberedsec Reading Mail with VM +@unnumberedsubsec Q4.0.1: How do I set up VM to retrieve mail from a remote site using POP? Use @code{vm-spool-files}, like this for example: @@ -3812,20 +3965,23 @@ Of course substitute your actual password for MYPASS. @node Q4.0.2, Q4.0.3, Q4.0.1, Subsystems -@section How do I get VM to filter mail for me? +@unnumberedsubsec Q4.0.2: How do I get VM to filter mail for me? One possibility is to use procmail to split your mail before it gets to VM. I prefer this personally, since there are many strange and wonderful things one can do with procmail. Procmail may be found at -<URL:ftp://ftp.informatik.rwth-aachen.de/pub/packages/procmail/>. +@uref{ftp://ftp.informatik.rwth-aachen.de/pub/packages/procmail/}. Also see the Mail Filtering FAQ at: -<URL:http://www.cis.ohio-state.edu/hypertext/faq/usenet/mail/filtering-faq/faq.html>. +@iftex +@* +@end iftex +@uref{http://www.cis.ohio-state.edu/hypertext/faq/usenet/mail/filtering-faq/faq.html}. @node Q4.0.3, Q4.0.4, Q4.0.2, Subsystems -@section How can I get VM to automatically check for new mail? - -John Turner <turner@@lanl.gov> writes: +@unnumberedsubsec Q4.0.3: How can I get VM to automatically check for new mail? + +@email{turner@@lanl.gov, John Turner} writes: @quotation Use the following: @@ -3836,38 +3992,39 @@ @end quotation @node Q4.0.4, Q4.0.5, Q4.0.3, Subsystems -@section [This question intentionally left blank] +@unnumberedsubsec Q4.0.4: [This question intentionally left blank] Obsolete question, left blank to avoid renumbering. @node Q4.0.5, Q4.0.6, Q4.0.4, Subsystems -@section How do I get my outgoing mail archived? +@unnumberedsubsec Q4.0.5: How do I get my outgoing mail archived? @lisp (setq mail-archive-file-name "~/outbox") @end lisp @node Q4.0.6, Q4.0.7, Q4.0.5, Subsystems -@section I have various addresses at which I receive mail. How can I tell VM to ignore them when doing a "reply-all"? +@unnumberedsubsec 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"? Set @code{vm-reply-ignored-addresses} to a list, like @lisp -(setq vm-reply-ignored-addresses '("wing@@netcom[0-9]*.netcom.com" - "wing@@netcom.com" "wing@@666.com")) +(setq vm-reply-ignored-addresses + '("wing@@nuspl@@nvwls.cc.purdue.edu,netcom[0-9]*.netcom.com" + "wing@@netcom.com" "wing@@666.com")) @end lisp Note that each string is a regular expression. @node Q4.0.7, Q4.0.8, Q4.0.6, Subsystems -@section Is there a mailing list or FAQ for VM? - -A FAQ for VM exists at <URL:http://www.cyberpass.net/~gorkab/vmfaq.htm>. +@unnumberedsubsec Q4.0.7: Is there a mailing list or FAQ for VM? + +A FAQ for VM exists at @uref{http://www.cyberpass.net/~gorkab/vmfaq.htm}. VM has its own newsgroups gnu.emacs.vm.info and gnu.emacs.vm.bug. -@node Q4.0.8, Q4.0.9, Q4.0.7, Subsystems -@section Remote mail reading with VM. +@node Q4.0.8, Q4.0.9, Q4.0.7, Subsystems +@unnumberedsubsec Q4.0.8: Remote mail reading with VM. My mailbox lives at the office on a big honkin server. My regular INBOX lives on my honkin desktop machine. I now can PPP to the office from @@ -3875,7 +4032,7 @@ home without storing it here and I'd like to use xemacs and VM at home... Is there a recommended setup? -Joseph J. Nuspl Jr. <nuspl@@nvwls.cc.purdue.edu> writes: +@email{nuspl@@nvwls.cc.purdue.edu, Joseph J. Nuspl Jr.} writes: @quotation There are several ways to do this. @@ -3896,7 +4053,7 @@ @end enumerate @end quotation -William Perry <wmperry@@monolith.spry.com> adds: + @email{wmperry@@monolith.spry.com, William Perry} adds: @quotation Or you could run a pop script periodically on your desktop machine, and @@ -3905,7 +4062,7 @@ @end quotation @node Q4.0.9, Q4.0.10, Q4.0.8, Subsystems -@section rmail or VM gets an error incorporating new mail. +@unnumberedsubsec Q4.0.9: rmail or VM gets an error incorporating new mail. Quoting the XEmacs PROBLEMS file: @@ -3913,7 +4070,7 @@ rmail and VM get new mail from @file{/usr/spool/mail/$USER} using a program called @code{movemail}. This program interlocks with @code{/bin/mail} using the protocol defined by @code{/bin/mail}. - + There are two different protocols in general use. One of them uses the @code{flock} system call. The other involves creating a lock file; @code{movemail} must be able to write in @file{/usr/spool/mail} in order @@ -3955,13 +4112,13 @@ @end quotation @node Q4.0.10, Q4.0.11, Q4.0.9, Subsystems -@section How do I make VM stay in a single frame? - -John S Cooper <John.Cooper@@Eng.Sun.COM> writes: +@unnumberedsubsec Q4.0.10: How do I make VM stay in a single frame? + +John.@email{Cooper@@Eng.Sun.COM, John S Cooper} writes: @quotation @lisp -; Don't use multiple frames + ; Don't use multiple frames (setq vm-frame-per-composition nil) (setq vm-frame-per-folder nil) (setq vm-frame-per-edit nil) @@ -3970,21 +4127,24 @@ @end quotation @node Q4.0.11, Q4.0.12, Q4.0.10, Subsystems -@section How do I make VM or mh-e display graphical smilies? +@unnumberedsubsec Q4.0.11: How do I make VM or mh-e display graphical smilies? For mh-e use the following: @lisp -(add-hook 'mh-show-mode-hook '(lambda () (smiley-region (point-min) - (point-max)))) +(add-hook 'mh-show-mode-hook '(lambda () + (smiley-region (point-min) + (point-max)))) @end lisp For vm use the following: @lisp (require 'messagexmas) (require 'smiley) -(add-hook 'vm-select-message-hook '(lambda () (smiley-region (point-min) - (point-max)))) +(add-hook 'vm-select-message-hook + '(lambda () + (smiley-region (point-min) + (point-max)))) @end lisp For tm use the following: @@ -3994,9 +4154,9 @@ @end lisp @node Q4.0.12, Q4.1.1, Q4.0.11, Subsystems -@section Customization of VM not covered in the manual, or here. - -giacomo boffi <boffi@@hp735.stru.polimi.it> writes: +@unnumberedsubsec Q4.0.12: Customization of VM not covered in the manual, or here. + +@email{boffi@@hp735.stru.polimi.it, giacomo boffi} writes: @quotation The meta-answer is to look into the file @file{vm-vars.el}, in the vm @@ -4017,49 +4177,51 @@ @end quotation @node Q4.1.1, Q4.1.2, Q4.0.12, Subsystems -@section What is W3? +@unnumberedsec Web browsing with W3 +@unnumberedsubsec Q4.1.1: What is W3? W3 is an advanced graphical browser written in Emacs lisp that runs on XEmacs. It has full support for cascaded style sheets, and more... It has a home web page at -<URL:http://www.cs.indiana.edu/elisp/w3/docs.html>. +@uref{http://www.cs.indiana.edu/elisp/w3/docs.html}. @node Q4.1.2, Q4.1.3, Q4.1.1, Subsystems -@section How do I run W3 from behind a firewall? +@unnumberedsubsec Q4.1.2: How do I run W3 from behind a firewall? There is a long, well-written, detailed section in the W3 manual that describes how to do this. Look in the section entitled "Firewalls". @node Q4.1.3, Q4.2.1, Q4.1.2, Subsystems -@section Is it true that W3 supports style sheets and tables? +@unnumberedsubsec Q4.1.3: Is it true that W3 supports style sheets and tables? Yes, and much more. W3, as distributed with the latest XEmacs is a full-featured web browser. @node Q4.2.1, Q4.2.2, Q4.1.3, Subsystems -@section GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus, Quassia Gnus, argh! +@unnumberedsec Reading Netnews and Mail with Gnus +@unnumberedsubsec Q4.2.1: GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus, Quassia Gnus, argh! The Gnus numbering issues are not meant for mere mortals to know them. If you feel you @emph{must} enter the muddy waters of Gnus, visit the excellent FAQ, maintained by Justin Sheehy, at: @example -<URL:http://www.ccs.neu.edu/software/gnus/> +@uref{http://www.ccs.neu.edu/software/gnus/} @end example See also Gnus home page @example -<URL:http://www.gnus.org/> +@uref{http://www.gnus.org/} @end example @node Q4.2.2, Q4.2.3, Q4.2.1, Subsystems -@section This question intentionally left blank. +@unnumberedsubsec Q4.2.2: This question intentionally left blank. Obsolete question, left blank to avoid renumbering. @node Q4.2.3, Q4.2.4, Q4.2.2, Subsystems -@section How do I make Gnus stay within a single frame? +@unnumberedsubsec Q4.2.3: How do I make Gnus stay within a single frame? The toolbar code to start Gnus opens the new frame---and it's a feature rather than a bug. If you don't like it, but would still like to click @@ -4074,15 +4236,21 @@ @code{gnus}, without all the fancy frame stuff. @node Q4.2.4, Q4.3.1, Q4.2.3, Subsystems -@section How do I customize the From: line? +@unnumberedsubsec Q4.2.4: How do I customize the From: line? How do I change the @code{From:} line? I have set gnus-user-from-line -to Gail Gurman <gail.gurman@@sybase.com>, but XEmacs Gnus doesn't use -it. Instead it uses Gail Mara Gurman <gailg@@deall> and then complains +to @example +Gail Gurman <gail.gurman@@sybase.com> +@end example +@noindent , but XEmacs Gnus doesn't use +it. Instead it uses @example +Gail Mara Gurman @email{gailg@@deall} +@end example +@noindent and then complains that it's incorrect. Also, as you perhaps can see, my Message-ID is screwy. How can I change that? -Lars Magne Ingebrigtsen <larsi@@aegir.ifi.uio.no> writes: +@email{larsi@@ifi.uio.no, Lars Magne Ingebrigtsen} writes: @quotation Set @code{user-mail-address} to @samp{gail.gurman@@sybase.com} or @@ -4090,22 +4258,32 @@ @end quotation @node Q4.3.1, Q4.3.2, Q4.2.4, Subsystems -@section How can I read and/or compose MIME messages? +@unnumberedsec Other Mail & News +@unnumberedsubsec Q4.3.1: How can I read and/or compose MIME messages? One answer is @code{tra-vm-mime}. You may find it at -<URL:http://lenkkari.cs.tut.fi/~tra/software/tra-vm-mime.el>. +@iftex +@* +@end iftex +@uref{http://lenkkari.cs.tut.fi/~tra/software/tra-vm-mime.el}. Another possibility is RMIME. You may find RMIME at -<URL:http://www.cinti.net/~rmoody/rmime/index.html>. +@iftex +@* +@end iftex +@uref{http://www.cinti.net/~rmoody/rmime/index.html}. You probably want to use the Tools for MIME (tm). @xref{Q4.3.2} for details. -Trey Jackson <trey@@cs.berkeley.edu> has an Emacs & MIME web page at -<URL:http://bmrc.berkeley.edu/~trey/emacs/mime.html>. +@email{trey@@cs.berkeley.edu, Trey Jackson} has an Emacs & MIME web page at +@iftex +@* +@end iftex +@uref{http://bmrc.berkeley.edu/~trey/emacs/mime.html}. @node Q4.3.2, Q4.3.3, Q4.3.1, Subsystems -@section What is TM and where do I get it? +@unnumberedsubsec Q4.3.2: What is TM and where do I get it? TM stands for @dfn{Tools for MIME} and not Tiny MIME. TM integrates with all major XEmacs packages like Gnus (all flavors), VM, MH-E, and @@ -4115,9 +4293,12 @@ TM now comes as a package with XEmacs 19.16 and XEmacs 20.2. -TM was written by MORIOKA Tomohiko <morioka@@jaist.ac.jp> and KOBAYASHI -Shuhei <shuhei-k@@jaist.ac.jp>. It is based on the work of UMEDA -Masanobu <umerin@@mse.kyutech.ac.jp>, the original writer of GNUS. +TM was written by @email{morioka@@jaist.ac.jp, MORIOKA Tomohiko} and +@email{shuhei-k@@jaist.ac.jp, KOBAYASHI +Shuhei}. + +It is based on the work of @email{umerin@@mse.kyutech.ac.jp, UMEDA +Masanobu}, the original writer of GNUS. The following information is from the @file{README}: @@ -4133,13 +4314,13 @@ tm is available from following anonymous ftp sites: @itemize @bullet -@item <URL:ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/> (Japan). -@item <URL:ftp://ftp.nis.co.jp/pub/gnu/emacs-lisp/tm/> (Japan). -@item <URL:ftp://ftp.nisiq.net/pub/gnu/emacs-lisp/tm/> (US). -@item <URL:ftp://ftp.miranova.com/pub/gnus/jaist.ac.jp/> (US). -@item <URL:ftp://ftp.unicamp.br/pub/mail/mime/tm/> (Brasil). -@item <URL:ftp://ftp.th-darmstadt.de/pub/editors/GNU-Emacs/lisp/mime/> (Germany). -@item <URL:ftp://ftp.tnt.uni-hannover.de/pub/editors/xemacs/contrib/> (Germany). +@item @uref{ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/} (Japan). +@item @uref{ftp://ftp.nis.co.jp/pub/gnu/emacs-lisp/tm/} (Japan). +@item @uref{ftp://ftp.nisiq.net/pub/gnu/emacs-lisp/tm/} (US). +@item @uref{ftp://ftp.miranova.com/pub/gnus/jaist.ac.jp/} (US). +@item @uref{ftp://ftp.unicamp.br/pub/mail/mime/tm/} (Brasil). +@item @uref{ftp://ftp.th-darmstadt.de/pub/editors/GNU-Emacs/lisp/mime/} (Germany). +@item @uref{ftp://ftp.tnt.uni-hannover.de/pub/editors/xemacs/contrib/} (Germany). @end itemize Don't let the installation procedure & instructions stop you from trying @@ -4147,54 +4328,65 @@ trivial to use. @node Q4.3.3, Q4.3.4, Q4.3.2, Subsystems -@section Why isn't this @code{movemail} program working? - -Ben Wing <ben@@666.com> writes: +@unnumberedsubsec Q4.3.3: Why isn't this @code{movemail} program working? + +Ben Wing @email{ben@@666.com} writes: @quotation It wasn't chown'ed/chmod'd correctly. @end quotation @node Q4.3.4, Q4.3.5, Q4.3.3, Subsystems -@section Movemail is also distributed by Netscape? Can that cause problems? - -Steve Baur <steve@@altair.xemacs.org> writes: +@unnumberedsubsec Q4.3.4: Movemail is also distributed by Netscape? Can that cause problems? + +@email{steve@@altair.xemacs.org, Steve Baur} writes: @quotation Yes. Always use the movemail installed with your XEmacs. Failure to do so can result in lost mail. @end quotation -Please refer to Jamie Zawinski's <jwz@@netscape.com> notes at -<URL:http://home.netscape.com/eng/mozilla/2.0/relnotes/demo/movemail.html>. +Please refer to @email{jwz@@netscape.com, Jamie Zawinski's} notes at +@iftex +@* +@end iftex +@uref{http://home.netscape.com/eng/mozilla/2.0/relnotes/demo/movemail.html}. In particular, this document will show you how to make Netscape use the version of movemail configured for your system by the person who built XEmacs. @node Q4.3.5, Q4.4.1, Q4.3.4, Subsystems -@section Where do I find pstogif (required by tm)? +@unnumberedsubsec Q4.3.5: Where do I find pstogif (required by tm)? pstogif is part of the latex2html package. -Jan Vroonhof <vroonhof@@math.ethz.ch> writes: +@email{vroonhof@@math.ethz.ch, Jan Vroonhof} writes: latex2html is best found at the CTAN hosts and their mirrors -in @file{tex-archive/support/latex2html}. +in +@iftex +@* +@end iftex +@file{tex-archive/support/latex2html}. CTAN hosts are: @itemize @bullet -@item <URL:ftp://ftp.tex.ac.uk/tex-archive/support/latex2html/>. -@item <URL:ftp://ftp.dante.de/tex-archive/support/latex2html/>. +@item @uref{ftp://ftp.tex.ac.uk/tex-archive/support/latex2html/}. +@item @uref{ftp://ftp.dante.de/tex-archive/support/latex2html/}. @end itemize There is a good mirror at ftp.cdrom.com; -<URL:ftp://ftp.cdrom.com/pub/tex/ctan/support/latex2html/>. +@iftex +@* +@end iftex +@uref{ftp://ftp.cdrom.com/pub/tex/ctan/support/latex2html/}. @node Q4.4.1, Q4.5.1, Q4.3.5, Subsystems -@section What is SPARCworks, EOS, and WorkShop? - -John Turner <turner@@lanl.gov> writes: +@unnumberedsec Sparcworks, EOS, and WorkShop +@unnumberedsubsec Q4.4.1: What is SPARCworks, EOS, and WorkShop? + +@email{turner@@lanl.gov, John Turner} writes: @quotation SPARCworks is SunSoft's development environment, comprising compilers @@ -4202,7 +4394,7 @@ tools such as TeamWare (for configuration management), MakeTool, etc. @end quotation -See <URL:http://www.sun.com/sunsoft/Developer-products/> +See @uref{http://www.sun.com/sunsoft/Developer-products/} for more info. EOS stands for "Era on SPARCworks", but I don't know what Era stands @@ -4214,7 +4406,7 @@ using the SPARCworks debugger. It works very well and I use it all the time. -Chuck Thompson <cthomp@@xemacs.org> writes: +@email{cthomp@@xemacs.org, Chuck Thompson} writes: @quotation Era stood for "Emacs Rewritten Again". It was what we were calling the @@ -4222,19 +4414,23 @@ to work on this wonderful editor. @end quotation -Martin Buchholz <martin@@xemacs.org> writes: +@email{martin@@xemacs.org, Martin Buchholz} writes: @quotation EOS is being replaced with a new graphical development environment called Sun WorkShop, which is currently (07/96) in Alpha Test. For more details, check out -<URL:http://www.sun.com/sunsoft/Products/Developer-products/programs.html>. +@iftex +@* +@end iftex +@uref{http://www.sun.com/sunsoft/Products/Developer-products/programs.html}. @end quotation @node Q4.5.1, Q4.6.1, Q4.4.1, Subsystems -@section What is/was Energize? - -David N Gray <gray@@meteor.harlequin.com> writes: +@unnumberedsec Energize +@unnumberedsubsec Q4.5.1: What is/was Energize? + +@email{gray@@meteor.harlequin.com, David N Gray} writes: @quotation The files in @file{lisp/energize} are to enable Emacs to interface with the "Energize Programming System", a C and C++ development environment, @@ -4247,13 +4443,14 @@ @end quotation @node Q4.6.1, Q4.7.1, Q4.5.1, Subsystems -@section What is Infodock? +@unnumberedsec Infodock +@unnumberedsubsec Q4.6.1: What is Infodock? InfoDock is an integrated productivity toolset, mainly aimed at technical people. It is developed and supported by InfoDock Associates, a firm that offers custom support and development -for InfoDock, XEmacs and GNU Emacs. (http://www.infodock.com, -<info@@infodock.com>, +1 408 243 3300). +for InfoDock, XEmacs and GNU Emacs. ( @uref{http://www.infodock.com}, +@email{info@@infodock.com}, +1 408 243 3300). InfoDock is built atop the XEmacs variant of GNU Emacs and so has all of the power of Emacs, but with an easier to use and more comprehensive @@ -4283,7 +4480,7 @@ InfoDock menus are much more extensive and more mature than standard Emacs menus. Each menu offers a @samp{Manual} item which displays documentation associated with the menu's functions. - + @noindent Four types of menubars are provided: @enumerate @@ -4335,15 +4532,18 @@ highlighting and browsing, and man page browsing. InfoDock questions, answers and discussion should go to the mail list -@samp{infodock@@infodock.com}. Use -@samp{infodock-request@@infodock.com} to be added or removed from the +@iftex +@* +@end iftex +@email{infodock@@infodock.com}. Use +@email{infodock-request@@infodock.com} to be added or removed from the list. Always include your InfoDock version number when sending help requests. InfoDock is available across the Internet via anonymous FTP. To get it, first move to a directory into which you want the InfoDock archive files placed. We will call this <DIST-DIR>. - + @example cd <DIST-DIR> @end example @@ -4356,10 +4556,10 @@ Login as @samp{anonymous} with your own <user-id>@@<site-name> as a password. -@example +@example Name (ftp.xemacs.org): anonymous 331 Guest login ok, send your complete e-mail address as password. - Password: -<your-user-id@@your-domain> + Password: -<your-user-id>@@<your-domain> 230 Guest login ok, access restrictions apply. @end example @@ -4403,9 +4603,10 @@ step-by-step installation instructions. @node Q4.7.1, Q4.7.2, Q4.6.1, Subsystems -@section What is AUC TeX? Where do you get it? - -AUC TeX is a package written by Per Abrahamsen <abraham@@dina.kvl.dk>. +@unnumberedsec Other Unbundled Packages +@unnumberedsubsec Q4.7.1: What is AUC TeX? Where do you get it? + +AUC TeX is a package written by @email{abraham@@dina.kvl.dk, Per Abrahamsen}. Starting with XEmacs 19.16, AUC TeX is bundled with XEmacs. The following information is from the @file{README} and website. @@ -4414,27 +4615,36 @@ are supported, including AMS TeX, LaTeX, and TeXinfo. The most recent version is always available by ftp at -<URL:ftp://sunsite.auc.dk/packages/auctex/auctex.tar.gz>. +@iftex +@* +@end iftex +@uref{ftp://sunsite.auc.dk/packages/auctex/auctex.tar.gz}. In case you don't have access to anonymous ftp, you can get it by an -email request to <URL:mailto:ftpmail@@decwrl.dec.com>. +email request to @email{ftpmail@@decwrl.dec.com}. WWW users may want to check out the AUC TeX page at -<URL:http://sunsite.auc.dk/auctex/>. +@iftex +@* +@end iftex +@uref{http://sunsite.auc.dk/auctex/}. @node Q4.7.2, Q4.7.3, Q4.7.1, Subsystems -@section Are there any Emacs Lisp Spreadsheets? +@unnumberedsubsec Q4.7.2: Are there any Emacs Lisp Spreadsheets? Yes. Check out @dfn{dismal} (which stands for Dis' Mode Ain't Lotus) at -<URL:ftp://cs.nyu.edu/pub/local/fox/dismal/>. +@iftex +@* +@end iftex +@uref{ftp://cs.nyu.edu/pub/local/fox/dismal/}. @node Q4.7.3, Q4.7.4, Q4.7.2, Subsystems -@section Byte compiling AUC TeX on XEmacs 19.14. - -Georges Brun-Cottan <bruncott@@dormeur.inria.fr> writes: +@unnumberedsubsec Q4.7.3: Byte compiling AUC TeX on XEmacs 19.14. + +@email{bruncott@@dormeur.inria.fr, Georges Brun-Cottan} writes: @quotation -When byte compiling auctex-9.4g, you must use the command: +When byte compiling auxtex-9.4g, you must use the command: @example xemacs -batch -l lpath.el @@ -4442,14 +4652,14 @@ @end quotation @node Q4.7.4, Q4.7.5, Q4.7.3, Subsystems -@section Problems installing AUC TeX. - -Jan Vroonhof <vroonhof@@math.ethz.ch> writes: +@unnumberedsubsec Q4.7.4: Problems installing AUC TeX. + +@email{vroonhof@@math.ethz.ch, Jan Vroonhof} writes: @quotation AUC TeX works fine on both stock Emacs and XEmacs has been doing so for -a very very long time. This is mostly due to the work of Per Abrahamsen -<abraham@@dina.kvl.dk> (clap clap) in particular his @file{easymenu} +a very very long time. This is mostly due to the work of +@email{abraham@@dina.kvl.dk, Per Abrahamsen} (clap clap) in particular his @file{easymenu} package. Which leads to what is probably the problem... @end quotation @@ -4471,7 +4681,7 @@ @node Q4.7.5, , Q4.7.4, Subsystems -@section Is there a reason for an Emacs package not to be included in XEmacs? +@unnumberedsubsec Q4.7.5: Is there a reason for an Emacs package not to be included in XEmacs? The reason for an Emacs package not to be included in XEmacs is usually one or more of the following: @@ -4510,7 +4720,7 @@ @end enumerate @node Miscellaneous, Current Events, Subsystems, Top -@chapter The Miscellaneous Stuff +@unnumbered 5 The Miscellaneous Stuff This is part 5 of the XEmacs Frequently Asked Questions list. This section is devoted to anything that doesn't fit neatly into the other @@ -4527,8 +4737,8 @@ * Q5.0.7:: Telnet from shell filters too much. * Q5.0.8:: Why does edt emulation not work? * Q5.0.9:: How can I emulate VI and use it as my default mode? -* Q5.0.10:: [This question intentionally left blank] -* Q5.0.11:: Filladapt doesn't work in 19.15? +* Q5.0.10:: [This question intentionally left blank] +* Q5.0.11:: Filladapt doesn't work in 19.15? * Q5.0.12:: How do I disable gnuserv from opening a new frame? * Q5.0.13:: How do I start gnuserv so that each subsequent XEmacs is a client? * Q5.0.14:: Strange things are happening in Shell Mode. @@ -4537,6 +4747,7 @@ * Q5.0.17:: How can I get two instances of info? * Q5.0.18:: I upgraded to XEmacs 19.14 and gnuserv stopped working * Q5.0.19:: Is there something better than LaTeX mode? +* Q5.0.20:: Is there a way to start a new XEmacs if there's no gnuserv running, and otherwise use gnuclient? Emacs Lisp Programming Techniques: * Q5.1.1:: The difference in key sequences between XEmacs and GNU Emacs? @@ -4572,7 +4783,8 @@ @end menu @node Q5.0.1, Q5.0.2, Miscellaneous, Miscellaneous -@section How can I do source code highlighting using font-lock? +@unnumberedsec Major & Minor Modes +@unnumberedsubsec Q5.0.1: How can I do source code highlighting using font-lock? For most modes, font-lock is already set up and just needs to be turned on. This can be done by @kbd{M-x font-lock-mode}, or by having XEmacs @@ -4590,7 +4802,7 @@ Remember to save options. @node Q5.0.2, Q5.0.3, Q5.0.1, Miscellaneous -@section I do not like cc-mode. How do I use the old c-mode? +@unnumberedsubsec Q5.0.2: I do not like cc-mode. How do I use the old c-mode? Well, first off, consider if you really want to do this. cc-mode is much more powerful than the old c-mode. If you're having trouble @@ -4606,14 +4818,14 @@ (makunbound 'c++-mode-map) (makunbound 'c-style-alist) (load-library "old-c-mode") -(load-library "old-c++-mode") +(load-library "old-c++-mode") @end lisp This must be done before any other reference is made to either c-mode or c++-mode. @node Q5.0.3, Q5.0.4, Q5.0.2, Miscellaneous -@section How do I get @samp{More} Syntax Highlighting on by default? +@unnumberedsubsec Q5.0.3: How do I get @samp{More} Syntax Highlighting on by default? Use the following code in your @file{.emacs}: @@ -4636,7 +4848,7 @@ Remember to save options. @node Q5.0.4, Q5.0.5, Q5.0.3, Miscellaneous -@section How can I enable auto-indent? +@unnumberedsubsec Q5.0.4: How can I enable auto-indent? Put the following line in your @file{.emacs}: @@ -4665,7 +4877,7 @@ Please note that the @code{fa-extras} package is no longer useful. @node Q5.0.5, Q5.0.6, Q5.0.4, Miscellaneous -@section How can I get XEmacs to come up in text/auto-fill mode by default? +@unnumberedsubsec Q5.0.5: How can I get XEmacs to come up in text/auto-fill mode by default? Try the following lisp in your @file{.emacs}: @@ -4710,7 +4922,7 @@ some programming language). @node Q5.0.6, Q5.0.7, Q5.0.5, Miscellaneous -@section How do I start up a second shell buffer? +@unnumberedsubsec Q5.0.6: How do I start up a second shell buffer? In the @code{*shell*} buffer: @@ -4725,7 +4937,7 @@ rename-buffer}. @node Q5.0.7, Q5.0.8, Q5.0.6, Miscellaneous -@section Telnet from shell filters too much +@unnumberedsubsec Q5.0.7: Telnet from shell filters too much I'm using the Emacs @kbd{M-x shell} function, and I would like to invoke and use a telnet session within it. Everything works fine except that @@ -4737,7 +4949,7 @@ if you have @code{ssh} installed. @node Q5.0.8, Q5.0.9, Q5.0.7, Miscellaneous -@section Why does edt emulation not work? +@unnumberedsubsec Q5.0.8: Why does edt emulation not work? We don't know, but you can use tpu-edt emulation instead, which works fine and is a little fancier than the standard edt emulation. To do @@ -4755,7 +4967,7 @@ @end lisp @node Q5.0.9, Q5.0.10, Q5.0.8, Miscellaneous -@section How can I emulate VI and use it as my default mode? +@unnumberedsubsec Q5.0.9: How can I emulate VI and use it as my default mode? Our recommended VI emulator is viper. To make viper-mode the default, add this to your @file{.emacs}: @@ -4764,7 +4976,7 @@ (viper-mode) @end lisp -Michael Kifer <kifer@@CS.SunySB.EDU> writes: +@email{kifer@@CS.SunySB.EDU, Michael Kifer} writes: @quotation This should be added as close to the top of @file{.emacs} as you can get @@ -4772,12 +4984,12 @@ @end quotation @node Q5.0.10, Q5.0.11, Q5.0.9, Miscellaneous -@section [This question intentionally left blank] +@unnumberedsubsec Q5.0.10: [This question intentionally left blank] Obsolete question, left blank to avoid renumbering - + @node Q5.0.11, Q5.0.12, Q5.0.10, Miscellaneous -@section Filladapt doesn't work in 19.15 +@unnumberedsubsec Q5.0.11: Filladapt doesn't work in 19.15 Filladapt 2.x is included in 19.15. In it filladapt is now a minor mode and minor modes are traditionally off by default. The following @@ -4791,11 +5003,11 @@ major modes, like this: @lisp -(add-hook 'text-mode-hook 'turn-on-filladapt-mode) +(add-hook 'text-mode-hook 'turn-on-filladapt-mode) @end lisp @node Q5.0.12, Q5.0.13, Q5.0.11, Miscellaneous -@section How do I disable gnuserv from opening a new frame? +@unnumberedsubsec Q5.0.12: How do I disable gnuserv from opening a new frame? If you set the @code{gnuserv-frame} variable to the frame that should be used to display buffers that are pulled up, a new frame will not be @@ -4819,7 +5031,7 @@ @node Q5.0.13, Q5.0.14, Q5.0.12, Miscellaneous -@section How do I start gnuserv so that each subsequent XEmacs is a client? +@unnumberedsubsec Q5.0.13: How do I start gnuserv so that each subsequent XEmacs is a client? Put the following in your @file{.emacs} file to start the server: @@ -4841,7 +5053,7 @@ See also man page of gnuclient. @node Q5.0.14, Q5.0.15, Q5.0.13, Miscellaneous -@section Strange things are happening in Shell Mode. +@unnumberedsubsec Q5.0.14: Strange things are happening in Shell Mode. Sometimes (i.e. it's not repeatable, and I can't work out why it happens) when I'm typing into shell mode, I hit return and only a @@ -4849,7 +5061,7 @@ returned. If I hit return again, the rest of the previous command is given to the shell. -Martin Buchholz <martin@@xemacs.org> writes: +@email{martin@@xemacs.org, Martin Buchholz} writes: @quotation There is a known problem with interaction between @code{csh} and the @@ -4862,16 +5074,16 @@ @end quotation @node Q5.0.15, Q5.0.16, Q5.0.14, Miscellaneous -@section Where do I get the latest CC Mode? - -Barry A. Warsaw <bwarsaw@@cnri.reston.va.us> writes: +@unnumberedsubsec Q5.0.15: Where do I get the latest CC Mode? + +@email{bwarsaw@@cnri.reston.va.us, Barry A. Warsaw} writes: @quotation -This can be had from <URL:http://www.python.org/ftp/emacs/>. +This can be had from @uref{http://www.python.org/ftp/emacs/}. @end quotation @node Q5.0.16, Q5.0.17, Q5.0.15, Miscellaneous -@section I find auto-show-mode disconcerting. How do I turn it off? +@unnumberedsubsec Q5.0.16: I find auto-show-mode disconcerting. How do I turn it off? @code{auto-show-mode} controls whether or not a horizontal scrollbar magically appears when a line is too long to be displayed. This is @@ -4884,36 +5096,66 @@ @end lisp @node Q5.0.17, Q5.0.18, Q5.0.16, Miscellaneous -@section How can I get two instances of info? +@unnumberedsubsec Q5.0.17: How can I get two instances of info? You can't. The @code{info} package does not provide for multiple info buffers. @node Q5.0.18, Q5.0.19, Q5.0.17, Miscellaneous -@section I upgraded to XEmacs 19.14 and gnuserv stopped working. - -Mark Daku <daku@@nortel.ca> writes: +@unnumberedsubsec Q5.0.18: I upgraded to XEmacs 19.14 and gnuserv stopped working. + +@email{daku@@nortel.ca, Mark Daku} writes: @quotation It turns out I was using an older version of gnuserv. The installation didn't put the binary into the public bin directory. It put it in +@iftex +@* +@end iftex @file{lib/xemacs-19.14/hppa1.1-hp-hpux9.05/gnuserv}. Shouldn't it have been put in @file{bin/hppa1.1-hp-hpux9.0}? @end quotation -@node Q5.0.19, Q5.1.1, Q5.0.18, Miscellaneous -@section Is there something better than LaTeX mode? - -David Kastrup <dak@@fsnif.neuroinformatik.ruhr-uni-bochum.de> writes: +@node Q5.0.19, Q5.0.20, Q5.0.18, Miscellaneous +@unnumberedsubsec Q5.0.19: Is there something better than LaTeX mode? + +@email{dak@@fsnif.neuroinformatik.ruhr-uni-bochum.de, David Kastrup} writes: @quotation The standard TeX modes leave much to be desired, and are somewhat leniently maintained. Serious TeX users use AUC TeX (@xref{Q4.7.1}). @end quotation -@node Q5.1.1, Q5.1.2, Q5.0.19, Miscellaneous -@section What is the difference in key sequences between XEmacs and GNU Emacs? - -Erik Naggum <erik@@naggum.no> writes; +@node Q5.0.20, Q5.1.1, Q5.0.19, Miscellaneous +@unnumberedsubsec Q5.0.20: Is there a way to start a new XEmacs if there's no gnuserv running, and otherwise use gnuclient? + +@email{vroonhof@@math.ethz.ch, Jan Vroonhof} writes: +@quotation +Here is one of the solutions, we have this in a script called +@file{etc/editclient.sh}. +@example + #!/bin/sh + if gnuclient -batch -eval t >/dev/null 2>&1 + then + exec gnuclient $@{1+"$@@"@} + else + xemacs -unmapped -f gnuserv-start & + until gnuclient -batch -eval t >/dev/null 2>&1 + do + sleep 1 + done + exec gnuclient $@{1+"$@@"@} + fi +@end example + +Note that there is a known problem when running XEmacs and 'gnuclient +-nw' on the same TTY. +@end quotation + +@node Q5.1.1, Q5.1.2, Q5.0.20, Miscellaneous +@unnumberedsec Emacs Lisp Programming Techniques +@unnumberedsubsec Q5.1.1: What is the difference in key sequences between XEmacs and GNU Emacs? + +@email{clerik@@naggum.no, Erik Naggum} writes; @quotation Emacs has a legacy of keyboards that produced characters with modifier @@ -4944,7 +5186,7 @@ you use. The function is available both on XEmacs and GNU Emacs. @node Q5.1.2, Q5.1.3, Q5.1.1, Miscellaneous -@section Can I generate "fake" keyboard events? +@unnumberedsubsec Q5.1.2: Can I generate "fake" keyboard events? I wonder if there is an interactive function that can generate @dfn{fake} keyboard events. This way, I could simply map them inside @@ -4959,13 +5201,13 @@ ;; Backspace and Delete stuff (global-set-key [backspace] - (lambda () (interactive) (cg--generate-char-event 127))) + (lambda () (interactive) (cg--generate-char-event 127))) (global-set-key [unknown_keysym_0x4] - (lambda () (interactive) (cg--generate-char-event 4))) + (lambda () (interactive) (cg--generate-char-event 4))) @end lisp @node Q5.1.3, Q5.1.4, Q5.1.2, Miscellaneous -@section Could you explain @code{read-kbd-macro} in more detail? +@unnumberedsubsec Q5.1.3: Could you explain @code{read-kbd-macro} in more detail? The @code{read-kbd-macro} function returns the internal Emacs representation of a human-readable string (which is its argument). @@ -4973,10 +5215,10 @@ @lisp (read-kbd-macro "C-c C-a") - @result{} [(control ?c) (control ?a)] +@result{} [(control ?c) (control ?a)] (read-kbd-macro "C-c C-. <up>") - @result{} [(control ?c) (control ?.) up] +@result{} [(control ?c) (control ?.) up] @end lisp In GNU Emacs the same forms will be evaluated to what GNU Emacs @@ -5040,7 +5282,11 @@ Any word may be prefixed by a multiplier in the form of a decimal number and @code{*}: @code{3*<right>} @equiv{} @code{<right> <right> <right>}, -and @code{10*foo} @equiv{} @code{foofoofoofoofoofoofoofoofoofoo}. +and @code{10*foo} @equiv{} +@iftex +@* +@end iftex +@code{foofoofoofoofoofoofoofoofoofoo}. Multiple text keys can normally be strung together to form a word, but you may need to add whitespace if the word would look like one of the @@ -5052,7 +5298,7 @@ @end quotation @node Q5.1.4, Q5.1.5, Q5.1.3, Miscellaneous -@section What is the performance hit of @code{let}? +@unnumberedsubsec Q5.1.4: What is the performance hit of @code{let}? In most cases, not noticeable. Besides, there's no avoiding @code{let}---you have to bind your local variables, after all. Some @@ -5062,7 +5308,7 @@ provide the clearest code. @node Q5.1.5, Q5.1.6, Q5.1.4, Miscellaneous -@section What is the recommended use of @code{setq}? +@unnumberedsubsec Q5.1.5: What is the recommended use of @code{setq}? @itemize @bullet @item Global variables @@ -5078,7 +5324,7 @@ @lisp (let ((case-fold-search nil)) - ... ; code with searches that must be case-sensitive + ... ; code with searches that must be case-sensitive ...) @end lisp @@ -5125,7 +5371,7 @@ @end itemize @node Q5.1.6, Q5.1.7, Q5.1.5, Miscellaneous -@section What is the typical misuse of @code{setq} ? +@unnumberedsubsec Q5.1.6: What is the typical misuse of @code{setq} ? A typical misuse is probably @code{setq}ing a variable that was meant to be local. Such a variable will remain bound forever, never to be @@ -5143,7 +5389,7 @@ @lisp (defun my-function (whatever) - (let (a) ; default initialization is to nil + (let (a) ; default initialization is to nil ... build a large list ... ... and exit, unbinding `a' in the process ...) @end lisp @@ -5156,18 +5402,18 @@ The reason for the warning is the following: @lisp -(defun flurgoze nil) ; ok, global internal variable +(defun flurgoze nil) ; ok, global internal variable ... -(setq flurghoze t) ; ops! a typo, but semantically correct. - ; however, the byte-compiler warns. +(setq flurghoze t) ; ops! a typo, but semantically correct. + ; however, the byte-compiler warns. While compiling toplevel forms: - ** assignment to free variable flurghoze +** assignment to free variable flurghoze @end lisp @node Q5.1.7, Q5.1.8, Q5.1.6, Miscellaneous -@section I like the the @code{do} form of cl, does it slow things down? +@unnumberedsubsec Q5.1.7: I like the the @code{do} form of cl, does it slow things down? It shouldn't. Here is what Dave Gillespie has to say about cl.el performance: @@ -5209,7 +5455,7 @@ @end quotation @node Q5.1.8, Q5.1.9, Q5.1.7, Miscellaneous -@section I like recursion, does it slow things down? +@unnumberedsubsec Q5.1.8: I like recursion, does it slow things down? Yes. Emacs byte-compiler cannot do much to optimize recursion. But think well whether this is a real concern in Emacs. Much of the Emacs @@ -5220,7 +5466,7 @@ gain. It's not usually worth it. @node Q5.1.9, Q5.1.10, Q5.1.8, Miscellaneous -@section How do I put a glyph as annotation in a buffer? +@unnumberedsubsec Q5.1.9: How do I put a glyph as annotation in a buffer? Here is a solution that will insert the glyph annotation at the beginning of buffer: @@ -5233,23 +5479,27 @@ (current-buffer)) @end lisp -Replace @samp{FORMAT} with an unquoted symbol representing the format of +Replace @samp{FORMAT} with an unquoted symbol representing the format of the image (e.g. @code{xpm}, @code{xbm}, @code{gif}, @code{jpeg}, etc.) Instead of @samp{FILE}, use the image file name -(e.g. @file{/usr/local/lib/xemacs-20.2/etc/recycle.xpm}). +(e.g. +@iftex +@* +@end iftex +@file{/usr/local/lib/xemacs-20.2/etc/recycle.xpm}). You can turn this to a function (that optionally prompts you for a file name), and inserts the glyph at @code{(point)} instead of @code{(point-min)}. @node Q5.1.10, Q5.2.1, Q5.1.9, Miscellaneous -@section @code{map-extents} won't traverse all of my extents! +@unnumberedsubsec Q5.1.10: @code{map-extents} won't traverse all of my extents! I tried to use @code{map-extents} to do an operation on all the extents -in a region. However, it seems to quit after processing a random number +in a region. However, it seems to quit after processing a random number of extents. Is it buggy? -No. The documentation of @code{map-extents} states that it will iterate +No. The documentation of @code{map-extents} states that it will iterate across the extents as long as @var{function} returns @code{nil}. Unexperienced programmers often forget to return @code{nil} explicitly, which results in buggy code. For instance, the following code is @@ -5274,7 +5524,7 @@ @end lisp @node Q5.2.1, Q5.2.2, Q5.1.10, Miscellaneous -@section How do I turn off the sound? +@unnumberedsubsec Q5.2.1: How do I turn off the sound? Add the following line to your @file{.emacs}: @@ -5283,7 +5533,7 @@ (setq sound-alist nil) @end lisp -That will make your XEmacs totally silent -- even the default ding sound +That will make your XEmacs totally silent -- even the default ding sound (TTY beep on TTY-s) will be gone. Starting with XEmacs-20.2 you can also change these with Customize. @@ -5293,7 +5543,7 @@ @node Q5.2.2, Q5.2.3, Q5.2.1, Miscellaneous -@section How do I get funky sounds instead of a boring beep? +@unnumberedsubsec Q5.2.2: How do I get funky sounds instead of a boring beep? Make sure your XEmacs was compiled with sound support, and then put this in your @file{.emacs}: @@ -5306,18 +5556,18 @@ versions. @node Q5.2.3, Q5.2.4, Q5.2.2, Miscellaneous -@section What's NAS, how do I get it? +@unnumberedsubsec Q5.2.3: What's NAS, how do I get it? @xref{Q2.0.3} for an explanation of the @dfn{Network Audio System}. @node Q5.2.4, Q5.3.1, Q5.2.3, Miscellaneous -@section Sunsite sounds don't play. +@unnumberedsubsec Q5.2.4: Sunsite sounds don't play. I'm having some trouble with sounds I've downloaded from sunsite. They play when I run them through @code{showaudio} or cat them directly to @file{/dev/audio}, but XEmacs refuses to play them. -Markus Gutschke <gutschk@@uni-muenster.de> writes: +@email{gutschk@@uni-muenster.de, Markus Gutschke} writes: @quotation [Many of] These files have an (erroneous) 24byte header that tells about @@ -5330,7 +5580,8 @@ @end quotation @node Q5.3.1, Q5.3.2, Q5.2.4, Miscellaneous -@section How do you make XEmacs indent CL if-clauses correctly? +@unnumberedsec Miscellaneous +@unnumberedsubsec Q5.3.1: How do you make XEmacs indent CL if-clauses correctly? I'd like XEmacs to indent all the clauses of a Common Lisp @code{if} the same amount instead of indenting the 3rd clause differently from the @@ -5366,7 +5617,7 @@ any indent-functions. @node Q5.3.2, Q5.3.3, Q5.3.1, Miscellaneous -@section Fontifying hang when editing a postscript file. +@unnumberedsubsec Q5.3.2: Fontifying hang when editing a postscript file. When I try to edit a postscript file it gets stuck saying: @samp{fontifying 'filename' (regexps....)} and it just sits there. If I @@ -5386,17 +5637,17 @@ files anymore. @node Q5.3.3, Q5.3.4, Q5.3.2, Miscellaneous -@section How can I print WYSIWYG a font-locked buffer? +@unnumberedsubsec Q5.3.3: How can I print WYSIWYG a font-locked buffer? Font-lock looks nice. How can I print (WYSIWYG) the highlighted document? The package @code{ps-print}, which is now included with XEmacs, provides the ability to do this. The source code contains complete instructions -on its use, in @file{<xemacs_src_root>/lisp/packages/ps-print.el}. +on its use, in @file{@email{xemacs_src_root}/lisp/packages/ps-print.el}. @node Q5.3.4, Q5.3.5, Q5.3.3, Miscellaneous -@section Getting @kbd{M-x lpr} to work with postscript printer. +@unnumberedsubsec Q5.3.4: Getting @kbd{M-x lpr} to work with postscript printer. My printer is a Postscript printer and @code{lpr} only works for Postscript files, so how do I get @kbd{M-x lpr-region} and @kbd{M-x @@ -5414,7 +5665,7 @@ versions of a2ps require a @samp{-Pprinter} to ensure spooling. @node Q5.3.5, Q5.3.6, Q5.3.4, Miscellaneous -@section How do I specify the paths that XEmacs uses for finding files? +@unnumberedsubsec Q5.3.5: How do I specify the paths that XEmacs uses for finding files? You can specify what paths to use by using a number of different flags when running configure. See the section MAKE VARIABLES in the top-level @@ -5429,12 +5680,12 @@ file. @node Q5.3.6, Q5.3.7, Q5.3.5, Miscellaneous -@section [This question intentionally left blank] +@unnumberedsubsec Q5.3.6: [This question intentionally left blank] Obsolete question, left blank to avoid renumbering. @node Q5.3.7, Q5.3.8, Q5.3.6, Miscellaneous -@section Can I have the end of the buffer delimited in some way? +@unnumberedsubsec Q5.3.7: Can I have the end of the buffer delimited in some way? Say, with: @samp{[END]}? @@ -5444,7 +5695,7 @@ (let ((ext (make-extent (point-min) (point-max)))) (set-extent-property ext 'start-closed t) (set-extent-property ext 'end-closed t) - (set-extent-property ext 'detachable nil) + (set-extent-property ext 'detachable nil) (set-extent-end-glyph ext (make-glyph [string :data "[END]"]))) @end lisp @@ -5465,7 +5716,7 @@ (let ((ext (make-extent (point-min) (point-max)))) (set-extent-property ext 'start-closed t) (set-extent-property ext 'end-closed t) - (set-extent-property ext 'detachable nil) + (set-extent-property ext 'detachable nil) (set-extent-end-glyph ext (make-glyph '([xpm :data "\ /* XPM */ static char* eye = @{ @@ -5477,17 +5728,17 @@ \"_c c #fefe00\", \"_d c #fe0000\", \"_e c #bfbfbf\", -\"___________`_`_`___b_b_b_b_________`____\", -\"_________`_`_`___b_c_c_c_b_b____________\", -\"_____`_`_`_e___b_b_c_c_c___b___b_______`\", -\"___`_`_e_a___b_b_d___b___b___b___b______\", -\"_`_`_e_a_e___b_b_d_b___b___b___b___b____\", -\"_`_`_a_e_a___b_b_d___b___b___b___b___b__\", -\"_`_`_e_a_e___b_b_d_b___b___b___b___b_b__\", -\"___`_`_e_a___b_b_b_d_c___b___b___d_b____\", -\"_____`_`_e_e___b_b_b_d_c___b_b_d_b______\", -\"_`_____`_`_`_`___b_b_b_d_d_d_d_b________\", -\"___`_____`_`_`_`___b_b_b_b_b_b__________\", +\"___________`_`_`___b_b_b_b_________`____\", +\"_________`_`_`___b_c_c_c_b_b____________\", +\"_____`_`_`_e___b_b_c_c_c___b___b_______`\", +\"___`_`_e_a___b_b_d___b___b___b___b______\", +\"_`_`_e_a_e___b_b_d_b___b___b___b___b____\", +\"_`_`_a_e_a___b_b_d___b___b___b___b___b__\", +\"_`_`_e_a_e___b_b_d_b___b___b___b___b_b__\", +\"___`_`_e_a___b_b_b_d_c___b___b___d_b____\", +\"_____`_`_e_e___b_b_b_d_c___b_b_d_b______\", +\"_`_____`_`_`_`___b_b_b_d_d_d_d_b________\", +\"___`_____`_`_`_`___b_b_b_b_b_b__________\", @} ;"] [string :data "[END]"])))) @end lisp @@ -5496,7 +5747,7 @@ We leave that as an exercise for the reader. @node Q5.3.8, Q5.3.9, Q5.3.7, Miscellaneous -@section How do I insert today's date into a buffer? +@unnumberedsubsec Q5.3.8: How do I insert today's date into a buffer? Like this: @@ -5505,9 +5756,9 @@ @end lisp @node Q5.3.9, Q5.3.10, Q5.3.8, Miscellaneous -@section Are only certain syntactic character classes available for abbrevs? - -Markus Gutschke <gutschk@@uni-muenster.de> writes: +@unnumberedsubsec Q5.3.9: Are only certain syntactic character classes available for abbrevs? + +@email{gutschk@@uni-muenster.de, Markus Gutschke} writes: @quotation Yes, abbrevs only expands word-syntax strings. While XEmacs does not @@ -5525,11 +5776,11 @@ Starting with XEmacs 20.3 this restriction has been lifted. @node Q5.3.10, Q5.3.11, Q5.3.9, Miscellaneous -@section How can I get those oh-so-neat X-Face lines? +@unnumberedsubsec Q5.3.10: How can I get those oh-so-neat X-Face lines? Firstly there is an ftp site which describes X-faces and has the associated tools mentioned below, at -<URL:ftp://ftp.cs.indiana.edu:/pub/faces/>. +@uref{ftp://ftp.cs.indiana.edu:/pub/faces/}. Then the steps are @@ -5550,7 +5801,11 @@ Then be sure to quote things that are necessary for emacs strings: @example -cat ./file.face | sed 's/\\/\\\\/g' | sed 's/\"/\\\"/g' > ./file.face.quoted +cat ./file.face | sed 's/\\/\\\\/g' +@iftex +\ @* +@end iftex +| sed 's/\"/\\\"/g' > ./file.face.quoted @end example @item @@ -5558,15 +5813,15 @@ couple of suggestions here---either something like: @lisp -(setq mail-default-headers - "X-Face: <Ugly looking text string here>") +(setq mail-default-headers + "X-Face: @email{Ugly looking text string here}") @end lisp Or, alternatively, as: @lisp (defun mail-insert-x-face () - (save-excursion + (save-excursion (goto-char (point-min)) (search-forward mail-header-separator) (beginning-of-line) @@ -5590,34 +5845,34 @@ Some people have also found that if one uses the @code{(insert-file)} method, one should NOT quote the face string using the sed script . -It might also be helpful to use Stig's <stig@@hackvan.com> script +It might also be helpful to use @email{stig@@hackvan.com, Stig's} script (included in the compface distribution at XEmacs.org) to do the conversion. For convenience xbm2xface is available for anonymous FTP at -<URL:ftp://ftp.miranova.com/pub/xemacs/xbm2xface.pl>. +@uref{ftp://ftp.miranova.com/pub/xemacs/xbm2xface.pl}. Contributors for this item: -Paul Emsley, +Paul Emsley, Ricardo Marek, Amir J. Katz, Glen McCort, -Heinz Uphoff, +Heinz Uphoff, Peter Arius, Paul Harrison, and Vegard Vesterheim @node Q5.3.11, Q5.3.12, Q5.3.10, Miscellaneous -@section How do I add new Info directories? +@unnumberedsubsec Q5.3.11: How do I add new Info directories? You use something like: @lisp -(setq Info-directory-list (cons - (expand-file-name "~/info") - Info-default-directory-list)) +(setq Info-directory-list (cons + (expand-file-name "~/info") + Info-default-directory-list)) @end lisp -David Masterson <davidm@@prism.kla.com> writes: +@email{davidm@@prism.kla.com, David Masterson} writes: @quotation Emacs Info and XEmacs Info do many things differently. If you're trying to @@ -5651,7 +5906,7 @@ @end quotation @node Q5.3.12, , Q5.3.11, Miscellaneous -@section What do I need to change to make printing work? +@unnumberedsubsec Q5.3.12: What do I need to change to make printing work? For regular printing there are two variables that can be customized. @@ -5695,7 +5950,7 @@ window system environment. It cannot be used outside of X11. @node Current Events, , Miscellaneous, Top -@chapter What the Future Holds +@unnumbered 6 What the Future Holds This is part 6 of the XEmacs Frequently Asked Questions list. This section will change monthly, and contains any interesting items that have @@ -5706,11 +5961,13 @@ @menu * Q6.0.1:: What is new in 20.2? * Q6.0.2:: What is new in 20.3? -* Q6.0.3:: Procedural changes in XEmacs development. +* Q6.0.3:: What is new in 20.4? +* Q6.0.4:: Procedural changes in XEmacs development. @end menu @node Q6.0.1, Q6.0.2, Current Events, Current Events -@section What is new in 20.2? +@unnumberedsec Changes +@unnumberedsubsec Q6.0.1: What is new in 20.2? The biggest changes in 20.2 include integration of EFS (the next generation of ange-ftp) and AUC Tex (the Emacs subsystem that includes a @@ -5723,7 +5980,7 @@ considered unstable. @node Q6.0.2, Q6.0.3, Q6.0.1, Current Events -@section What is new in 20.3? +@unnumberedsubsec Q6.0.2: What is new in 20.3? XEmacs 20.3 was released in November 1997. It contains many bugfixes, and a number of new features, including Autoconf 2 based configuration, @@ -5742,20 +5999,31 @@ XEmacs 20.3 is the first non-beta v20 release, and will be the basis for all further development. -@node Q6.0.3, , Q6.0.2, Current Events -@section Procedural changes in XEmacs development. +@node Q6.0.3, Q6.0.4, Q6.0.2, Current Events +@unnumberedsubsec Q6.0.3: What's new in XEmacs 20.4? + +XEmacs 20.4 is a bugfix release with no user-visible changes. +@c Filled in from NEWS file of 20.5-b33 + + +@node Q6.0.4, , Q6.0.3, Current Events +@unnumberedsubsec Q6.0.4: Procedural changes in XEmacs development. @enumerate @item Discussion about the development of XEmacs occurs on the xemacs-beta mailing list. Subscriptions to this list will now be fully automated instead of being handled by hand. Send a mail message to -<xemacs-beta-request@@xemacs.org> with a subject of subscribe to join +@email{xemacs-beta-request@@xemacs.org} with a subject of subscribe to join the list. Please note this is a developers mailing list for people who have an active interest in the development process. The discussion of NT XEmacs development is taking place on a separate -mailing list. Send mail to <xemacs-nt-request@@xemacs.org> to +mailing list. Send mail to +@iftex +@* +@end iftex +@email{xemacs-nt-request@@xemacs.org} to subscribe. @item @@ -5767,7 +6035,7 @@ the collected bugfixes. @item -As of December 1996, Steve Baur <steve@@altair.xemacs.org> has become +As of December 1996, @email{steve@@altair.xemacs.org, Steve Baur} has become the lead maintainer of XEmacs. @end enumerate