From 7d6596b8a9e165e37642d1078a8c88832388b56e Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Mon, 17 Oct 2005 02:35:03 +0000 Subject: [PATCH] (Compilation Mode, Compilation): Clarified. --- man/ChangeLog | 4 ++++ man/building.texi | 29 ++++++++++++++++++----------- 2 files changed, 22 insertions(+), 11 deletions(-) diff --git a/man/ChangeLog b/man/ChangeLog index afd79737ae9..d582230c71f 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,7 @@ +2005-10-16 Richard M. Stallman + + * building.texi (Compilation Mode, Compilation): Clarified. + 2005-10-15 Richard M. Stallman * misc.texi (Saving Emacs Sessions): Mention savehist library. diff --git a/man/building.texi b/man/building.texi index eb7a8bb00fe..093c839cbc9 100644 --- a/man/building.texi +++ b/man/building.texi @@ -63,17 +63,16 @@ command; normally, therefore, the compilation happens in this directory. @vindex compile-command - When the shell command line is read, the minibuffer appears -containing a default command line, which is the command you used the -last time you did @kbd{M-x compile}. If you type just @key{RET}, the -same command line is used again. For the first @kbd{M-x compile}, the -default is @samp{make -k}, which is correct most of the time for -nontrivial programs. (@xref{Top,, Make, make, GNU Make Manual}.) -The default compilation command comes from the variable -@code{compile-command}; if the appropriate compilation command for a -file is something other than @samp{make -k}, it can be useful for the -file to specify a local value for @code{compile-command} (@pxref{File -Variables}). + The default for the compilation command is normally @samp{make -k}, +which is correct most of the time for nontrivial programs. +(@xref{Top,, Make, make, GNU Make Manual}.) If you have done @kbd{M-x +compile} before, the default each time is the command you used the +previous time. @code{compile} stores this command in the variable +@code{compile-command}, so setting that variable specifies the default +for the next use of @kbd{M-x compile}. If a file specifies a file +local value for @code{compile-command}, that provides the default when +you type @kbd{M-x compile} in that file's buffer. @xref{File +Variables}. Starting a compilation displays the buffer @samp{*compilation*} in another window but does not select it. The buffer's mode line tells @@ -232,6 +231,14 @@ if the current buffer can be the target of @code{next-error}, it is used. Else, all the buffers Emacs manages are tried for @code{next-error} support. + If you're not in the compilation buffer when you run +@code{next-error}, Emacs will look for a buffer that contains error +messages. First, it looks for one displayed in the selected frame, +then for one that previously had @code{next-error} called on it, and +then at the current buffer. Finally, Emacs looks at all the remaining +buffers. @code{next-error} signals an error if it can't find any such +buffer. + @kbd{C-u C-x `} starts scanning from the beginning of the compilation buffer. This is one way to process the same set of errors again. -- 2.39.5