From: Chong Yidong Date: Mon, 17 Nov 2008 01:38:47 +0000 (+0000) Subject: (Compilation): Document first-error value of compilation-scroll-output. X-Git-Tag: emacs-pretest-23.0.90~1755 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=07799e9ae1d2763bb9c7dfc8736fbf1a9aa347bf;p=emacs.git (Compilation): Document first-error value of compilation-scroll-output. (Compilation Mode): Note that compilation-auto-jump-to-first-error works as soon as an error is available. Suggested by Juri Linkov. --- diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi index 8b6bfd84c78..f69c6a62823 100644 --- a/doc/emacs/building.texi +++ b/doc/emacs/building.texi @@ -92,9 +92,12 @@ the end of the buffer. @cindex compilation buffer, keeping point at end @vindex compilation-scroll-output - If you set the variable @code{compilation-scroll-output} to a -non-@code{nil} value, then the compilation buffer always scrolls to -follow output as it comes in. + If you change the variable @code{compilation-scroll-output} to a +non-@code{nil} value, the compilation buffer will scroll automatically +to follow the output as it comes in. If the value is +@code{first-error}, the scrolling stops at the first error that +appears, leaving point at that error. For any other non-@code{nil} +value, the buffer continues scrolling until there is no more output. @findex recompile To rerun the last compilation with the same command, type @kbd{M-x @@ -201,8 +204,8 @@ typing @key{RET} (@code{compile-goto-error}). Alternatively, you can click @kbd{Mouse-2} on the error message; you need not switch to the @samp{*compilation*} buffer first. If you set the variable @code{compilation-auto-jump-to-first-error} to a non-@code{nil} value, -Emacs automatically jumps to the first error (if any exists) once -compilation finishes. +Emacs automatically jumps to the first error, if any, as soon as it +appears in the @samp{*compilation*} buffer. @kindex M-g M-n @kindex M-g n