From 3f95e42e7b875c512f696d5a4892a1d1d9d3be4d Mon Sep 17 00:00:00 2001 From: Alexandre Duret-Lutz Date: Fri, 17 Dec 2004 23:46:58 +0000 Subject: [PATCH] * doc/automake.texi: Correct several misuses of @xref and @pxref. --- ChangeLog | 4 ++++ doc/automake.texi | 22 +++++++++++----------- doc/stamp-vti | 2 +- doc/version.texi | 2 +- 4 files changed, 17 insertions(+), 13 deletions(-) diff --git a/ChangeLog b/ChangeLog index 534465195..23c7e3751 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2004-12-18 Alexandre Duret-Lutz + + * doc/automake.texi: Correct several misuses of @xref and @pxref. + 2004-12-17 Jim Meyering * install-sh: Use `(exit N); exit N', not `(exit N); exit'. diff --git a/doc/automake.texi b/doc/automake.texi index 224d2df1c..849b240cd 100644 --- a/doc/automake.texi +++ b/doc/automake.texi @@ -1512,7 +1512,7 @@ argument, @command{aclocal} assumes the file belongs to the package 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. @@ -3058,7 +3058,7 @@ library, a shared library, or maybe both. Their exact nature cannot 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 @@ -3357,7 +3357,7 @@ files) or libtool libraries (@file{.la}) to add to @var{library}. 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 @@ -3901,7 +3901,7 @@ Libtool libraries (where the expected object extension is @file{.lo}): @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}. @@ -4838,7 +4838,7 @@ For header files that are built and must not be distributed, use the @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 @@ -5800,7 +5800,7 @@ packaging tool. @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 @@ -6209,7 +6209,7 @@ not the place where the test suite author should define new variables: 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}. @@ -6411,7 +6411,7 @@ This options is meaningful only when passed as an argument to @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} @@ -8154,7 +8154,7 @@ Automake to think that this is actually a per-target variable (like 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 @@ -8169,7 +8169,7 @@ obeys this naming scheme. The slight difference is that 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. @@ -8181,7 +8181,7 @@ variable implies that of an @code{AM_} variable or that of a user 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 diff --git a/doc/stamp-vti b/doc/stamp-vti index 5b2a59cda..edd70b853 100644 --- a/doc/stamp-vti +++ b/doc/stamp-vti @@ -1,4 +1,4 @@ -@set UPDATED 12 December 2004 +@set UPDATED 18 December 2004 @set UPDATED-MONTH December 2004 @set EDITION 1.9a @set VERSION 1.9a diff --git a/doc/version.texi b/doc/version.texi index 5b2a59cda..edd70b853 100644 --- a/doc/version.texi +++ b/doc/version.texi @@ -1,4 +1,4 @@ -@set UPDATED 12 December 2004 +@set UPDATED 18 December 2004 @set UPDATED-MONTH December 2004 @set EDITION 1.9a @set VERSION 1.9a -- 2.47.2