and uses @code{m4_include} instead of copying it into
@file{aclocal.m4}. This makes the package smaller, eases dependency
tracking, and cause the file to be distributed automatically.
-(@pxref{Local Macros} for an example.) Any macro which is found in a
+(See @ref{Local Macros} for an example.) Any macro which is found in a
system-wide directory, or via an absolute search path will be copied.
So use @code{-I `pwd`/reldir} instead of @code{-I reldir} whenever
some relative directory need to be considered outside the package.
be determined until @file{./configure} is run: not all platforms
support all kinds of libraries, and users can explicitly select which
libraries should be built. (However the package's maintainers can
-tune the default, @xref{AC_PROG_LIBTOOL, , The @code{AC_PROG_LIBTOOL}
+tune the default, @ref{AC_PROG_LIBTOOL, , The @code{AC_PROG_LIBTOOL}
macro, libtool, The Libtool Manual}.)
@cindex suffix @file{.lo}, defined
The @samp{@var{library}_LDFLAGS} variable is the place to list
additional libtool linking flags, such as @samp{-version-info},
-@samp{-static}, and a lot more. See @xref{Link mode, , Link mode,
+@samp{-static}, and a lot more. @xref{Link mode, , Link mode,
libtool, The Libtool Manual}.
The @command{libtool} command has two kinds of options: mode-specific
@code{LTLIBOBJS} is defined automatically by Autoconf and should not
be defined by hand (as in the past), however at the time of writing
@code{LTALLOCA} still needs to be defined from @code{ALLOCA} manually.
-See @ref{AC_LIBOBJ vs LIBOBJS, , @code{AC_LIBOBJ} vs. @code{LIBOBJS},
+@xref{AC_LIBOBJ vs LIBOBJS, , @code{AC_LIBOBJ} vs. @code{LIBOBJS},
autoconf, The Autoconf Manual}.
@samp{nodist_} prefix as in @code{nodist_include_HEADERS} or
@code{nodist_prog_SOURCES}. If these generated headers are needed
during the build, you must also ensure they exist before they are
-used, see @xref{Sources}.
+used, see @ref{Sources}.
@node Data
@cindex @code{make clean} support
The GNU Makefile Standards specify a number of different clean rules.
-See @xref{Standard Targets, , Standard Targets for Users, standards,
+@xref{Standard Targets, , Standard Targets for Users, standards,
The GNU Coding Standards}.
Generally the files that can be cleaned are determined automatically by
this should be done elsewhere in the real test suite code.
Especially, @file{site.exp} should not be distributed.
-For more information regarding DejaGnu test suites, see @xref{Top, , ,
+For more information regarding DejaGnu test suites, see @ref{Top, , ,
dejagnu, The DejaGnu Manual}.
In either case, the testing is done via @samp{make check}.
@opindex no-dependencies
This is similar to using @samp{--include-deps} on the command line, but
is useful for those situations where you don't have the necessary bits
-to make automatic dependency tracking work @xref{Dependencies}. In this
+to make automatic dependency tracking work @ref{Dependencies}. In this
case the effect is to effectively disable automatic dependency tracking.
@item @code{no-dist}
There are other variables in Automake that follow similar principles
to allow user options. For instance Texinfo rules (@pxref{Texinfo})
uses @code{MAKEINFOFLAGS} and @code{AM_MAKEINFOFLAGS}. Similarly,
-DejaGnu tests @pxref{Tests} use @code{RUNTESTDEFAULTFLAGS} and
+DejaGnu tests (@pxref{Tests}) use @code{RUNTESTDEFAULTFLAGS} and
@code{AM_RUNTESTDEFAULTFLAGS}. The tags and ctags rules
(@pxref{Tags}) use @code{ETAGSFLAGS}, @code{AM_ETAGSFLAGS},
@code{CTAGSFLAGS}, and @code{AM_CTAGSFLAGS}. Java rules
However you should not think that all variables ending with
@code{FLAGS} follow this convention. For instance
@code{DISTCHECK_CONFIGURE_FLAGS} (@pxref{Dist}),
-@code{ACLOCAL_AMFLAGS} (@pxref{Rebuilding} and @ref{Local Macros}),
+@code{ACLOCAL_AMFLAGS} (see @ref{Rebuilding} and @ref{Local Macros}),
are two variables that are only useful to the maintainer and have no
user counterpart.
variable. For instance the @code{mumble_LDADD} per-target variable
overrides the global @code{LDADD} variable (which is not a user
variable), and @code{mumble_LIBADD} exists only as a per-target
-variable. (@pxref{Program and Library Variables}.)
+variable. @xref{Program and Library Variables}.
@node renamed objects