Hello,
Here is a patch with a proposal for change of --reorder-cache
description.
* remove the information that the library cache is unconfigured as
it is not useful to understand what is going on
* add the footnote directly in the text as it is important
* change slightly the text to adapt to the changes
* remove 'where @code{make install} has been required before
@code{make check} for the shared library cache to be updated.'
as it is not clear and not useful.
* introduce the examples as illustrating the effects of the option
and not usage example, as the context and use of the examples is not
explained
Still not a native english speaker.
--
Pat
diff --git a/doc/libtool.texi b/doc/libtool.texi
index 07aa1e7e..facb4ae4 100644
--- a/doc/libtool.texi
+++ b/doc/libtool.texi
@@ -1289,18 +1289,16 @@ library cache with @option{--reorder-cache=@var{shared_lib_dirs}}.
@item --reorder-cache=@var{shared_lib_dirs}
Reorder the shared library cache by providing the preferred directories
-(@var{shared_lib_dirs}) to link shared libraries from. The previous
-shared library cache is unconfigured, and the preferred directories are
-configured with the previous directories appended to the end (if not in
-the preferred directory list)@footnote{Additionally, all directories
-that no longer exist will be removed from the shared library cache.}.
-This option is currently only available on OpenBSD where @code{make
-install} has been required before @code{make check} for the shared
-library cache to be updated.
+(@var{shared_lib_dirs}) first to link shared libraries from. The directories
+previously present in the shared library cache are appended to the end
+(if not in the preferred directory list). Additionally, all directories
+that no longer exist are removed from the shared library cache. This
+option is currently only available on OpenBSD.
This option is essentially a wrapper for executing @command{ldconfig},
and it should be used as an independent option before and after testing
-changes to shared libraries. Below are some usage examples:
+changes to shared libraries. Below are some examples of the effects of
+the option:
@example
$ @kbd{libtool --reorder-cache=/tmp/testing}
