[PATCH 3/3] docs: document the new 'info-in-builddir' option

[Stefano Lattarini]

* doc/automake.texi: Here.
* NEWS: And here.

Signed-off-by: Stefano Lattarini <address@hidden>
---
 NEWS              |  7 +++++++
 doc/automake.texi | 11 +++++++++++
 2 files changed, 18 insertions(+)

diff --git a/NEWS b/NEWS
index 71e96ae..3972558 100644
--- a/NEWS
+++ b/NEWS
@@ -2,6 +2,13 @@ New in 1.14:
 
 * Texinfo support:
 
+  - Automake can now be instructed to place '.info' files generated from
+    Texinfo input in the builddir rather than in the srcdir; this is done
+    specifying the new automake option 'info-in-builddir'.  This feature
+    was requested by the developers of GCC, GDB, GNU binutils and the GNU
+    bfd library.  See the extensive discussion about automake bug#11034
+    for more details.
+
   - Automake used to implement an undocumented hack causing '.info' files
     that appeared to be cleaned (by e.g. being listed in the CLEANFILES
     variable) to also be built in the builddir rather than in the srcdir;
diff --git a/doc/automake.texi b/doc/automake.texi
index bac074c..ad4014f 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -7776,6 +7776,11 @@ install} (unless you use @option{no-installinfo}, see 
below).
 Furthermore, @file{.info} files are automatically distributed so that
 Texinfo is not a prerequisite for installing your package.
 
+It is worth noting that, contrary to what happens with the other formats,
+the generated @file{.info} files are by default placed in @code{srcdir}
+rather than in the @code{builddir}.  This can be changed with the
address@hidden option.
+
 @trindex dvi
 @trindex html
 @trindex pdf
@@ -10009,6 +10014,12 @@ options below.  This option should be used in the 
top-level
 @file{configure.ac}, it will be ignored otherwise.  It will also be
 ignored in sub-packages of nested packages (@pxref{Subpackages}).
 
address@hidden @option{info-in-builddir}
address@hidden Option, @option{info-in-builddir}
address@hidden info-in-builddir
+Instruct Automake to place the generated @file{.info} files in the
address@hidden rather than in the @code{srcdir}.
+
 @item @option{no-define}
 @cindex Option, @option{no-define}
 @opindex no-define
-- 
1.8.1.rc3.27.g3b73c7d