+ --aclocal-path=PATHS colon-separated paths to search for third-party
+ local files
Maybe "colon-separated list of directories".
Or "colon-separated path".
+@item --aclocal-path=@var{dir}
@var{dir} -> @var{path}
+@opindex --aclocal-path
+Look for local third-party macro files (and the special @file{dirlist}
+file) in @var{dir} instead of in the installation directory. This is
in @var{dir} -> along @var{path} (a colon-separated list of directories)
+typically used for building against local sysroots.
Can we link to somewhere that explains what this means?
Or at least have a parenthetical sentence of explanation?
+@vindex ACLOCAL_PATH
+The environment variable @env{ACLOCAL_PATH} provides another way to
+set the directory containing local third-party macro files.
s/directory/search path for directories/
... However
+@option{--aclocal-path} takes precedence over it.
It's not really "However". Also, it needs to be clear that if
--aclocal-path is specified. How about:
This variable is ignored if the @{--ac-local-path} option is specified.
-@subsubheading Modifying the Macro Search Path: @file{ACLOCAL_PATH}
+@subsubheading Modifying the Macro Search Path: @option{--aclocal-path}
It seems you've sometimes replaced ACLOCAL_PATH with --aclocal-path.
But ACLOCAL_PATH still exists. So it seems like both should be
mentioned. You do that in some places, but didn't seem like all.
Thanks,
Karl
