[elpa] externals/auctex 7f64d6c 15/36: Update the FAQ entry about failing `TeX-next-error' behavior

[Stefan Monnier]

branch: externals/auctex
commit 7f64d6c4ffc58dde44e6bb7c00d1b4640a2fe15b
Author: Davide G. M. Salvetti <address@hidden>
Date:   Sat Nov 15 11:48:34 2014 +0100

    Update the FAQ entry about failing `TeX-next-error' behavior
    
    * doc/faq.texi: Update the `Why does 'TeX-next-error' ('C-c `') fail?'
    entry, taking into account the `TeX-file-line-error' option.  Update
    copyright range.
---
 ChangeLog    |    4 ++++
 doc/faq.texi |   20 +++++++++++---------
 2 files changed, 15 insertions(+), 9 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 58eb378..8fbb2e5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2014-11-15  Davide G. M. Salvetti  <address@hidden>
 
+        * doc/faq.texi: Update the `Why does 'TeX-next-error' ('C-c `')
+        fail?' entry, taking into account the `TeX-file-line-error'
+        option.  Update copyright range.
+
         * doc/auctex.texi (Selecting a Command): Fix typo.
         (Automatic Local): Update description of `TeX-style-path',
         `TeX-style-global', `TeX-style-local', and `TeX-auto-local'
diff --git a/doc/faq.texi b/doc/faq.texi
index f634560..94a0e8d 100644
--- a/doc/faq.texi
+++ b/doc/faq.texi
@@ -1,5 +1,5 @@
 @c This is part of the AUCTeX Manual.
address@hidden Copyright (C) 2004, 2005, 2006, 2007 Free Software Foundation, 
Inc.
address@hidden Copyright (C) 2004-2014 Free Software Foundation, Inc.
 @c See the file auctex.texi for copying conditions.
 @ifset rawfile
 @include macros.texi
@@ -128,18 +128,20 @@ error in your init file.
 @item
 Why does @code{TeX-next-error} (@kbd{C-c `}) fail?
 
-When writing the log file, @TeX{} puts information related to a file,
-including error messages, between a pair of parentheses.  @AUCTeX{}
+If @code{TeX-file-line-error} is set to nil (not the default), these
+sort of failures might be related to the the fact that when writing the
+log file, @TeX{} puts information related to a file, including error
+messages, between a pair of parentheses.  In this scenario @AUCTeX{}
 determines the file where the error happened by parsing the log file and
 counting the parentheses.  This can fail when there are other,
 unbalanced parentheses present.
 
-As a workaround you can activate so-called file:line:error messages for
-the log file.  (Those are are easier to parse, but may lack some
-details.)  Either you do this in the configuration of your @TeX{} system
-(consult its manual to see where this is) or you add a command line
-switch to the (la)tex call, e.g. by customizing
address@hidden or @code{TeX-command-list}.
+Activating so-called file:line:error messages for the log file usually
+solves this issue, as these kind of messages are are easier to parse;
+however, they may lack some details.  Activation can be done either in
+the configuration of your @TeX{} system (consult its manual to see where
+this is) or by simply keeping the variable @code{TeX-file-line-error} to
+the default value of non-nil.
 
 @item
 What does AUC stand for?