# HG changeset patch
# User Chong Yidong <cyd@stupidchicken.com>
# Date 1226885927 0
# Node ID 1f2d2e0198b0bd6dd9139d22c63f5a4debffb01e
# Parent  fec70eb8cdf5d79fce8fa2b63661878f060ac074
(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 -r fec70eb8cdf5 -r 1f2d2e0198b0 doc/emacs/building.texi
--- a/doc/emacs/building.texi	Mon Nov 17 01:38:08 2008 +0000
+++ b/doc/emacs/building.texi	Mon Nov 17 01:38:47 2008 +0000
@@ -92,9 +92,12 @@
 
 @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 @@
 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