FYI: PR/382: document AM_YFLAGS = -d & BUILT_SOURCES

[Alexandre Duret-Lutz]

I'm installing this on HEAD and branch-1-7.

2003-01-14  Alexandre Duret-Lutz  <address@hidden>

        For PR automake/382:
        * automake.texi (Yacc and Lex): Document `AM_YFLAGS = -d'.
        Explain BUILT_SOURCES is usually needed in this case.
        Reported by William S Fulton.

Index: THANKS
===================================================================
RCS file: /cvs/automake/automake/THANKS,v
retrieving revision 1.200
diff -u -r1.200 THANKS
--- THANKS      10 Jan 2003 18:15:19 -0000      1.200
+++ THANKS      14 Jan 2003 07:24:11 -0000
@@ -203,4 +203,5 @@
 Ulrich Drepper         address@hidden
 Vadim Zeitlin          address@hidden
 Werner Koch            address@hidden
+William S Fulton       address@hidden
 Yann Droneaud          address@hidden
Index: automake.texi
===================================================================
RCS file: /cvs/automake/automake/automake.texi,v
retrieving revision 1.316
diff -u -r1.316 automake.texi
--- automake.texi       9 Jan 2003 12:45:33 -0000       1.316
+++ automake.texi       14 Jan 2003 07:24:34 -0000
@@ -53,7 +53,7 @@
 
 @page
 @vskip 0pt plus 1filll
-Copyright @copyright{} 1995, 1996, 2000, 2001, 2002 Free Software Foundation, 
Inc.
+Copyright @copyright{} 1995, 1996, 2000, 2001, 2002, 2003 Free Software 
Foundation, Inc.
 @sp 2
 This is the first edition of the GNU Automake documentation,@*
 and is consistent with GNU Automake @address@hidden
@@ -2702,11 +2702,28 @@
 @samp{AM_YFLAGS}.  The former is a user variable and the latter is
 intended for the @file{Makefile.am} author.
 
-Similarly, if a @code{lex} source file is seen, then your
address@hidden must define the variable @samp{LEX}.  You can use
address@hidden to do this (@pxref{Particular Programs, , Particular
-Program Checks, autoconf, The Autoconf Manual}), but using
address@hidden macro (@pxref{Macros}) is recommended.
address@hidden is usually used to pass the @code{-d} option to
address@hidden  Automake knows what this means and will automatically
+adjust its rules to update and distribute the header file built by
address@hidden -d}.  What Automake cannot guess, though, is where this
+header will be used: it is up to you to ensure the header gets built
+before it is first used.  Typically this is necessary in order for
+dependency tracking to work when the header is included by another
+file.  The common solution is listing the header file in
address@hidden (@pxref{Sources}) as follows.
+
address@hidden
+BUILT_SOURCES = parser.h
+AM_YFLAGS = -d
+bin_PROGRAMS = foo
+foo_SOURCES = @dots{} parser.y @dots{}
address@hidden example
+
+If a @code{lex} source file is seen, then your @file{configure.in}
+must define the variable @samp{LEX}.  You can use @samp{AC_PROG_LEX}
+to do this (@pxref{Particular Programs, , Particular Program Checks,
+autoconf, The Autoconf Manual}), but using @code{AM_PROG_LEX} macro
+(@pxref{Macros}) is recommended.
 
 When @code{lex} is invoked, it is passed @samp{LFLAGS} and
 @samp{AM_LFLAGS}.  The former is a user variable and the latter is

-- 
Alexandre Duret-Lutz