Changes to emacs/doc/emacs/building.texi,v

[Juri Linkov <juri@jurta.org>]

In the 2008-10-31 commit of building.texi I noticed the following change:

   @findex compile-goto-error
  +@vindex compilation-auto-jump-to-first-error
     You can visit the source for any particular error message by moving
   point in the @samp{*compilation*} buffer to that error message and
   typing @key{RET} (@code{compile-goto-error}).  Alternatively, you can
   click @kbd{Mouse-2} on the error message; you need not switch to the
  - <at> samp{*compilation*} buffer first.
  +@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.

Actually it jumps to the first error immediately after it occurs.

Perhaps this is caused by the inaccuracy in the doc string of
`compilation-auto-jump-to-first-error' that says:

  If non-nil, automatically jump to the first error after `compile'.

A better variant would be:

  If non-nil, automatically jump to the first error during `compile'.

BTW, maybe a new option `first-error' of `compilation-scroll-output'
should be documented in the manual too?

-- 
Juri Linkov
http://www.jurta.org/emacs/