Re: LIBOBJS warning in documentation no longer required?

[Bruno Haible]

Colin Watson wrote:
> Should this paragraph be removed from the documentation, and perhaps be
> replaced

Yes, this is old doc. I'm replacing it like this:

2007-10-15  Bruno Haible  <address@hidden>

        * doc/gnulib-tool.texi (Initial import): Swap order of -I directives.
        Replace paragraph talking about LIBOBJS.
        Reported by Colin Watson <address@hidden>.

*** doc/gnulib-tool.texi.orig   2007-10-15 15:50:18.000000000 +0200
--- doc/gnulib-tool.texi        2007-10-15 15:48:29.000000000 +0200
***************
*** 218,224 ****
  
  @example
  ...
! AM_CPPFLAGS = -I$(top_srcdir)/lib -I$(top_builddir)/lib
  ...
  LDADD = lib/libgnu.a
  ...
--- 218,224 ----
  
  @example
  ...
! AM_CPPFLAGS = -I$(top_builddir)/lib -I$(top_srcdir)/lib
  ...
  LDADD = lib/libgnu.a
  ...
***************
*** 239,253 ****
  @samp{_GNU_SOURCE} may be ineffective, or may have only a limited
  effect, if defined after the first system header file is included.
  
! A final word of warning: Gnulib currently assumes it will be
! responsible for @emph{all} functions that end up in the Autoconf
! @code{@@LIBOBJS@@} variables (and/or @code{@@LTLIBOBJS@@} if using
! Libtool), e.g., those specified in @code{AC_REPLACE_FUNCS} in your
! @file{configure.ac}.  Therefore, if you have any functions which are
! not covered by Gnulib which need that treatment, you have to
! essentially reimplement AC_REPLACE_FUNCS using different names; for an
! example, see the Findutils sources.  Perhaps this will be improved in
! the future.
  
  
  @node Modified imports
--- 239,252 ----
  @samp{_GNU_SOURCE} may be ineffective, or may have only a limited
  effect, if defined after the first system header file is included.
  
! Finally, note that you can not use @code{AC_LIBOBJ} or
! @code{AC_REPLACE_FUNCS} in your @file{configure.ac} and expect the
! resulting object files to be automatically added to @file{lib/libgnu.a}.
! This is because your @code{AC_LIBOBJ} and @code{AC_REPLACE_FUNCS} invocations
! from @file{configure.ac} augment a variable @code{@@LIBOBJS@@} (and/or
! @code{@@LTLIBOBJS@@} if using Libtool), whereas @file{lib/libgnu.a}
! is build from the contents of a different variable, usually
! @code{@@gl_LIBOBJS@@} (or @code{@@gl_LTLIBOBJS@@} is using Libtool).
  
  
  @node Modified imports