/[emacs]/emacs/man/faq.texi
ViewVC logotype

Diff of /emacs/man/faq.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.49.2.4 by miles, Fri Aug 27 07:00:30 2004 UTC revision 1.49.2.5 by miles, Sat Sep 4 09:14:25 2004 UTC
# Line 17  Copyright 1990,1991,1992 Joseph Brian We Line 17  Copyright 1990,1991,1992 Joseph Brian We
17    
18  @quotation  @quotation
19  This list of frequently asked questions about GNU Emacs with answers  This list of frequently asked questions about GNU Emacs with answers
20  ("FAQ") may be translated into other languages, transformed into other  (``FAQ'') may be translated into other languages, transformed into other
21  formats (e.g. Texinfo, Info, WWW, WAIS), and updated with new information.  formats (e.g. Texinfo, Info, WWW, WAIS), and updated with new information.
22    
23  The same conditions apply to any derivative of the FAQ as apply to the FAQ  The same conditions apply to any derivative of the FAQ as apply to the FAQ
# Line 906  where that is). Line 906  where that is).
906  Emacs General Public License  Emacs General Public License
907    
908  @item DISTRIB  @item DISTRIB
909  Emacs Availability Information, including the popular "Free Software  Emacs Availability Information, including the popular Free Software
910  Foundation Order Form"  Foundation Order Form
911    
912  @item FTP  @item FTP
913  How to get GNU Software by Internet FTP or by UUCP  How to get GNU Software by Internet FTP or by UUCP
# Line 935  Emacs news, a history of recent user-vis Line 935  Emacs news, a history of recent user-vis
935  GNU Service Directory  GNU Service Directory
936    
937  @item SUN-SUPPORT  @item SUN-SUPPORT
938  including "Using Emacstool with GNU Emacs"  including ``Using Emacstool with GNU Emacs''
939    
940  @end table  @end table
941    
# Line 1045  send usenet/news.answers/GNU-Emacs-FAQ/p Line 1045  send usenet/news.answers/GNU-Emacs-FAQ/p
1045  @end example  @end example
1046    
1047  For more information, send email to @email{mail-server@@rtfm.mit.edu}  For more information, send email to @email{mail-server@@rtfm.mit.edu}
1048  with "help" and "index" in the body on separate lines.  with @samp{help} and @samp{index} in the body on separate lines.
1049    
1050  @item  @item
1051  As the very last resort, you can e-mail a request to  As the very last resort, you can e-mail a request to
# Line 1864  edge of the window. Line 1864  edge of the window.
1864  @end itemize  @end itemize
1865    
1866  @node Overwrite mode, Turning off beeping, Horizontal scrolling, Common requests  @node Overwrite mode, Turning off beeping, Horizontal scrolling, Common requests
1867  @section How do I make Emacs "typeover" or "overwrite" instead of inserting?  @section How do I make Emacs ``typeover'' or ``overwrite'' instead of inserting?
1868  @cindex @key{Insert}  @cindex @key{Insert}
1869  @cindex @code{overwrite-mode}  @cindex @code{overwrite-mode}
1870  @cindex Overwriting existing text  @cindex Overwriting existing text
# Line 2075  onwards), to look at the resource names Line 2075  onwards), to look at the resource names
2075  was compiled with the X toolkit.  was compiled with the X toolkit.
2076    
2077  @node Evaluating Emacs Lisp code, Changing the length of a Tab, Valid X resources, Common requests  @node Evaluating Emacs Lisp code, Changing the length of a Tab, Valid X resources, Common requests
2078  @section How do I execute ("evaluate") a piece of Emacs Lisp code?  @section How do I execute (``evaluate'') a piece of Emacs Lisp code?
2079  @cindex Evaluating Lisp code  @cindex Evaluating Lisp code
2080  @cindex Lisp forms, evaluating  @cindex Lisp forms, evaluating
2081    
# Line 2162  since version 19.20.  @xref{Changing the Line 2162  since version 19.20.  @xref{Changing the
2162  additional information.  additional information.
2163    
2164  @node Underlining paragraphs, Repeating a command as many times as possible, Inserting > at the beginning of each line, Common requests  @node Underlining paragraphs, Repeating a command as many times as possible, Inserting > at the beginning of each line, Common requests
2165  @section How do I insert "_^H" before each character in a region to get an underlined paragraph?  @section How do I insert @samp{_^H} before each character in a region to get an underlined paragraph?
2166  @cindex Underlining a region of text  @cindex Underlining a region of text
2167  @cindex @code{underline-region}  @cindex @code{underline-region}
2168    
# Line 2264  Quick command-line switch descriptions a Line 2264  Quick command-line switch descriptions a
2264  You probably don't want to do this, since backups are useful, especially  You probably don't want to do this, since backups are useful, especially
2265  when something goes wrong.  when something goes wrong.
2266    
2267  To avoid seeing backup files (and other "uninteresting" files) in Dired,  To avoid seeing backup files (and other ``uninteresting'' files) in Dired,
2268  load @code{dired-x} by adding the following to your @file{.emacs} file:  load @code{dired-x} by adding the following to your @file{.emacs} file:
2269    
2270  @lisp  @lisp
# Line 2733  sizes of up to 33,554,431 bytes): Line 2733  sizes of up to 33,554,431 bytes):
2733  @end example  @end example
2734    
2735  @noindent  @noindent
2736  This method may result in "ILLEGAL DATATYPE" and other random errors on  This method may result in ``ILLEGAL DATATYPE'' and other random errors on
2737  some machines.  some machines.
2738    
2739  @email{daveg@@csvax.cs.caltech.edu, David Gillespie} explains how this  @email{daveg@@csvax.cs.caltech.edu, David Gillespie} explains how this
# Line 2824  stty -icrnl -onlcr -echo susp ^Z Line 2824  stty -icrnl -onlcr -echo susp ^Z
2824  @end example  @end example
2825    
2826  @node Shell process exits abnormally, Problems with Shell Mode on MS-Windows, ^M in the shell buffer, Bugs and problems  @node Shell process exits abnormally, Problems with Shell Mode on MS-Windows, ^M in the shell buffer, Bugs and problems
2827  @section Why do I get "Process shell exited abnormally with code 1"?  @section Why do I get ``Process shell exited abnormally with code 1''?
2828  @cindex Abnormal exits from @code{shell-mode}  @cindex Abnormal exits from @code{shell-mode}
2829  @cindex @code{shell-mode} exits  @cindex @code{shell-mode} exits
2830  @cindex Process shell exited  @cindex Process shell exited
# Line 2881  antivirus software; disabling the reside Line 2881  antivirus software; disabling the reside
2881  the problems in those cases.  the problems in those cases.
2882    
2883  @node Termcap/Terminfo entries for Emacs, Spontaneous entry into isearch-mode, Problems with Shell Mode on MS-Windows, Bugs and problems  @node Termcap/Terminfo entries for Emacs, Spontaneous entry into isearch-mode, Problems with Shell Mode on MS-Windows, Bugs and problems
2884  @section Where is the termcap/terminfo entry for terminal type "emacs"?  @section Where is the termcap/terminfo entry for terminal type @samp{emacs}?
2885  @cindex Termcap  @cindex Termcap
2886  @cindex Terminfo  @cindex Terminfo
2887  @cindex Emacs entries for termcap/terminfo  @cindex Emacs entries for termcap/terminfo
# Line 2915  if ("$term" == emacs) set term=dumb Line 2915  if ("$term" == emacs) set term=dumb
2915  @end example  @end example
2916    
2917  @node Spontaneous entry into isearch-mode, Problems talking to certain hosts, Termcap/Terminfo entries for Emacs, Bugs and problems  @node Spontaneous entry into isearch-mode, Problems talking to certain hosts, Termcap/Terminfo entries for Emacs, Bugs and problems
2918  @section Why does Emacs spontaneously start displaying "I-search:" and beeping?  @section Why does Emacs spontaneously start displaying @samp{I-search:} and beeping?
2919  @cindex Spontaneous entry into isearch-mode  @cindex Spontaneous entry into isearch-mode
2920  @cindex isearch-mode, spontaneous entry into  @cindex isearch-mode, spontaneous entry into
2921  @cindex Beeping without obvious reason  @cindex Beeping without obvious reason
# Line 2972  properly told to do DNS lookups with the Line 2972  properly told to do DNS lookups with the
2972  @end itemize  @end itemize
2973    
2974  @node Errors with init files, Emacs ignores X resources, Problems talking to certain hosts, Bugs and problems  @node Errors with init files, Emacs ignores X resources, Problems talking to certain hosts, Bugs and problems
2975  @section Why does Emacs say "Error in init file"?  @section Why does Emacs say @samp{Error in init file}?
2976  @cindex Error in @file{.emacs}  @cindex Error in @file{.emacs}
2977  @cindex Error in init file  @cindex Error in init file
2978  @cindex Init file, errors in  @cindex Init file, errors in
# Line 3238  access control enabled, only authorized Line 3238  access control enabled, only authorized
3238  @end itemize  @end itemize
3239    
3240  @node Dired claims that no file is on this line,  , Security risks with Emacs, Bugs and problems  @node Dired claims that no file is on this line,  , Security risks with Emacs, Bugs and problems
3241  @section Dired says, "no file on this line" when I try to do something.  @section Dired says, @samp{no file on this line} when I try to do something.
3242  @cindex Dired does not see a file  @cindex Dired does not see a file
3243    
3244  @c FIXME: I think this is fixed in Emacs 21, but I didn't have time to  @c FIXME: I think this is fixed in Emacs 21, but I didn't have time to
# Line 3441  Emacs needs to be linked with the static Line 3441  Emacs needs to be linked with the static
3441  @file{libX11.a}.  This may be missing.  @file{libX11.a}.  This may be missing.
3442    
3443  On OpenWindows, you may need to use @code{add_services} to add the  On OpenWindows, you may need to use @code{add_services} to add the
3444  "OpenWindows Programmers" optional software category from the CD-ROM.  ``OpenWindows Programmers'' optional software category from the CD-ROM.
3445    
3446  On HP-UX 8.0, you may need to run @code{update} again to load the  On HP-UX 8.0, you may need to run @code{update} again to load the
3447  X11-PRG ``fileset''.  This may be missing even if you specified ``all  X11-PRG ``fileset''.  This may be missing even if you specified ``all
# Line 3580  A list of sites mirroring @samp{ftp.gnu. Line 3580  A list of sites mirroring @samp{ftp.gnu.
3580  @uref{http://www.gnu.org/order/ftp.html}  @uref{http://www.gnu.org/order/ftp.html}
3581    
3582  @node Difference between Emacs and XEmacs, Emacs for MS-DOS, Current GNU distributions, Finding Emacs and related packages  @node Difference between Emacs and XEmacs, Emacs for MS-DOS, Current GNU distributions, Finding Emacs and related packages
3583  @section What is the difference between Emacs and XEmacs (formerly "Lucid Emacs")?  @section What is the difference between Emacs and XEmacs (formerly Lucid Emacs)?
3584  @cindex XEmacs  @cindex XEmacs
3585  @cindex Difference Emacs and XEmacs  @cindex Difference Emacs and XEmacs
3586  @cindex Lucid Emacs  @cindex Lucid Emacs
3587  @cindex Epoch  @cindex Epoch
3588    
3589  XEmacs is a branch version of Emacs.  It was earlier called as Lucid  XEmacs is a branch version of Emacs.  It was first called Lucid Emacs,
3590  Emacs, and it was based on a prerelease version of Emacs 19.  In this  and was initially derived from a prerelease version of Emacs 19.  In
3591  FAQ, we use the name ``Emacs'' only for the official version.  this FAQ, we use the name ``Emacs'' only for the official version.
3592    
3593  Emacs and XEmacs each come with Lisp packages that are lacking in the  Emacs and XEmacs each come with Lisp packages that are lacking in the
3594  other.  The two versions have some significant differences at the Lisp  other.  The two versions have some significant differences at the Lisp
3595  programming level.  programming level.  Their current features are roughly comparable,
3596    though the support for some operating systems, character sets and
3597  Many XEmacs features have found their way into recent versions of Emacs,  specific packages might be quite different.
3598  and more features can be expected in the future, but there are still many  
3599  differences between the two.  Some XEmacs code has been contributed to Emacs, and we would like to
3600    use other parts, but the earlier XEmacs maintainers did not always
3601  The FSF has used some of the code in XEmacs, and would like to use  keep track of the authors of contributed code, which makes it
3602  other parts, but the earlier XEmacs maintainers did not always keep  impossible for the FSF to get copyright papers signed for that code.
3603  track of the authors of contributed code, which makes it impossible  (The FSF requires these papers for all the code included in the Emacs
3604  for the FSF to get copyright papers signed for that code.  (The FSF  release, aside from generic C support packages that retain their
3605  requires these papers for all the code included in Emacs, aside from  separate identity and are not integrated into the code of Emacs
3606  generic C support packages that are not integrated into the code of  proper.)
3607  Emacs proper.)  
3608    If you want to talk about these two versions and distinguish them,
3609    please call them ``Emacs'' and ``XEmacs.''  To contrast ``XEmacs''
3610    with ``GNU Emacs'' would be misleading, since XEmacs too has its
3611    origin in the work of the GNU Project.  Terms such as ``Emacsen'' and
3612    ``(X)Emacs'' are not wrong, but they are not very clear, so it
3613    is better to write ``Emacs and XEmacs.''
3614    
3615  @node Emacs for MS-DOS, Emacs for Windows, Difference between Emacs and XEmacs, Finding Emacs and related packages  @node Emacs for MS-DOS, Emacs for Windows, Difference between Emacs and XEmacs, Finding Emacs and related packages
3616  @section Where can I get Emacs for my PC running MS-DOS?  @section Where can I get Emacs for my PC running MS-DOS?
# Line 3620  Windows (3.X, 9X, ME, NT, and 2000) and Line 3626  Windows (3.X, 9X, ME, NT, and 2000) and
3626  Windows 9X, Windows ME, and Windows 2000.  More information is available  Windows 9X, Windows ME, and Windows 2000.  More information is available
3627  from  from
3628    
3629  @uref{http://www.simtel.net/pub/djgpp/v2gnu/emacs.README}  @uref{ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/emacs.README}
3630    
3631  The binary itself is available in the files @file{em*.zip} in the  The binary itself is available in the files @file{em*.zip} in the
3632  directory  directory
3633    
3634  @uref{http://www.simtel.net/pub/djgpp/v2gnu/}  @uref{ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/}
3635    
3636  If you prefer to compile Emacs for yourself, you can do so with the  If you prefer to compile Emacs for yourself, you can do so with the
3637  current distribution directly.  You will need a 386 (or  current distribution directly.  You will need a 386 (or
3638  better) processor, and to be running MS-DOS 3.0 or later.  According to  better) processor, and to be running MS-DOS 3.0 or later.  According to
3639  @email{eliz@@is.elta.co.il, Eli Zaretskii} and  @email{eliz@@gnu.org, Eli Zaretskii} and
3640  @email{hankedr@@dms.auburn.edu, Darrel Hankerson}, you will need the  @email{hankedr@@dms.auburn.edu, Darrel Hankerson}, you will need the
3641  following:  following:
3642    
# Line 3644  long file names on Windows 9X/ME/2K. Line 3650  long file names on Windows 9X/ME/2K.
3650  You can get the latest release of DJGPP by retrieving all of  You can get the latest release of DJGPP by retrieving all of
3651  the files in  the files in
3652    
3653  @uref{http://www.simtel.net/pub/gnu/djgpp/v2*}  @uref{ftp://ftp.delorie.com/pub/djgpp/current/v2*}
3654    
3655  @item Unpacking program  @item Unpacking program
3656  The easiest way is to use @code{djtar} which comes with DJGPP v2.x,  The easiest way is to use @code{djtar} which comes with DJGPP v2.x,
# Line 3663  actually prevent Emacs from building suc Line 3669  actually prevent Emacs from building suc
3669  @item make, mv, sed, and rm  @item make, mv, sed, and rm
3670  All of these utilities are available at  All of these utilities are available at
3671    
3672  @uref{http://www.simtel.net/pub/gnu/djgpp/v2gnu}  @uref{ftp://ftp.delorie.com/pub/djgpp/current/v2gnu}
3673    
3674  16-bit utilities can be found in GNUish, at  16-bit utilities can be found in GNUish, at
3675    
# Line 3680  directory of the Emacs sources contains Line 3686  directory of the Emacs sources contains
3686  regarding Emacs under MS-DOS.  regarding Emacs under MS-DOS.
3687    
3688  For a list of other MS-DOS implementations of Emacs (and Emacs  For a list of other MS-DOS implementations of Emacs (and Emacs
3689  look-alikes), consult the list of "Emacs implementations and literature,"  look-alikes), consult the list of ``Emacs implementations and literature,''
3690  available at  available at
3691    
3692  @uref{ftp://rtfm.mit.edu/pub/usenet/comp.emacs/}  @uref{ftp://rtfm.mit.edu/pub/usenet/comp.emacs/}
# Line 3765  menus, and multiple frames.  You can get Line 3771  menus, and multiple frames.  You can get
3771  @cindex Apple computers, Emacs for  @cindex Apple computers, Emacs for
3772  @cindex Macintosh, Emacs for  @cindex Macintosh, Emacs for
3773    
 An unofficial port of GNU Emacs 18.59 to the Macintosh is available at a  
 number of ftp sites, the home being  
 @uref{ftp://ftp.cs.cornell.edu/pub/parmet/Emacs-1.17.sit.bin}.  
   
 A port of Emacs 20.4 is available at  
 @uref{http://www.cs.hku.hk/~choi/emacs/index.html}.  
   
3774  Beginning with version 21.1, the Macintosh is supported in the official  Beginning with version 21.1, the Macintosh is supported in the official
3775  Emacs distribution; see the files @file{mac/README} and  Emacs distribution; see the files @file{mac/README} and
3776  @file{mac/INSTALL} in the Emacs distribution for build instructions.  @file{mac/INSTALL} in the Emacs distribution for build instructions.
3777    
3778  Apple's forthcoming "OS X" is based largely on NeXTSTEP and OpenStep.  Apple's ``OS X'' is based largely on NeXTSTEP and OpenStep.
3779  @xref{Emacs for NeXTSTEP}, for more details about that version.  @xref{Emacs for NeXTSTEP}, for more details about that version.
3780    
3781  @node Emacs for VMS and DECwindows, Modes for various languages, Emacs for Apple computers, Finding Emacs and related packages  @node Emacs for VMS and DECwindows, Modes for various languages, Emacs for Apple computers, Finding Emacs and related packages
# Line 4171  sunsite.auc.dk Line 4170  sunsite.auc.dk
4170  @end table  @end table
4171    
4172  @node Patch,  , JDE, Major packages and programs  @node Patch,  , JDE, Major packages and programs
4173  @section Patch --- program to apply "diffs" for updating files  @section Patch --- program to apply ``diffs'' for updating files
4174  @cindex Updating files with diffs  @cindex Updating files with diffs
4175  @cindex Patching source files with diffs  @cindex Patching source files with diffs
4176  @cindex Diffs and patching  @cindex Diffs and patching
# Line 4244  command are required.  For example, Line 4243  command are required.  For example,
4243    
4244  @noindent  @noindent
4245  can be placed directly into the @file{.emacs} file.  If the key binding is  can be placed directly into the @file{.emacs} file.  If the key binding is
4246  local, the command is used in conjunction with the "add-hook" command.  local, the command is used in conjunction with the @samp{add-hook} function.
4247  For example, in tex-mode, a local binding might be  For example, in TeX mode, a local binding might be
4248    
4249  @lisp  @lisp
4250  (add-hook 'tex-mode-hook  (add-hook 'tex-mode-hook
# Line 4284  can be bound to a key and thus treated a Line 4283  can be bound to a key and thus treated a
4283  @end itemize  @end itemize
4284    
4285  @node Invalid prefix characters, Terminal setup code works after Emacs has begun, Binding keys to commands, Key bindings  @node Invalid prefix characters, Terminal setup code works after Emacs has begun, Binding keys to commands, Key bindings
4286  @section Why does Emacs say "Key sequence XXX uses invalid prefix characters"?  @section Why does Emacs say @samp{Key sequence XXX uses invalid prefix characters}?
4287  @cindex Prefix characters, invalid  @cindex Prefix characters, invalid
4288  @cindex Invalid prefix characters  @cindex Invalid prefix characters
4289  @cindex Misspecified key sequences  @cindex Misspecified key sequences
# Line 4679  translation. Line 4678  translation.
4678  @cindex Generating control characters  @cindex Generating control characters
4679  @cindex Control characters, generating  @cindex Control characters, generating
4680    
4681  On terminals (but not under X), some common "aliases" are:  On terminals (but not under X), some common ``aliases'' are:
4682    
4683  @table @asis  @table @asis
4684    

Legend:
Removed from v.1.49.2.4  
changed lines
  Added in v.1.49.2.5

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26