Hello,
Here is a patch with a proposal for changing the --no-finish
explanation, which changes the order to explain what it does, first
generally, then for OpenBSD, and only after explains why it could be
useful. Also tries to be clearer. I am not a native english speaker,
therefore the english could be wrong.
--
Pat
diff --git a/doc/libtool.texi b/doc/libtool.texi
index 07aa1e7e..879aac2e 100644
--- a/doc/libtool.texi
+++ b/doc/libtool.texi
@@ -1275,17 +1275,18 @@ required, this option will preserve them, only stripping the libraries
that libtool knows it can safely.
@item --no-finish
-Do not execute finish_cmds (disabled by default). This option is for
-specifying that testing of local changes to shared libraries is being
-performed so that ldconfig will not alter the shared library cache, which
-is an issue observed on OpenBSD 7.5. This option should be combined with
-the usage of @option{--mode=install} and @option{--mode=finish} to have
-any effect. Prior to utilizing this option, the shared library cache must
-not contain links to the listed install directory for shared libraries
-undergoing testing; otherwise, it will have no useful effect. In OpenBSD,
-the shared library cache can be reordered to prefer directories for
-testing shared libraries over the directories already listed in the shared
-library cache with @option{--reorder-cache=@var{shared_lib_dirs}}.
+Do not execute finish_cmds (disabled by default). This option should
+be combined with the usage of @option{--mode=install} and
+@option{--mode=finish} to have any effect. This option is relevant
+for OpenBSD 7.5, where ldconfig adds the shared libraries install
+directory to the shared library cache directories list. Specifying this
+option is useful on that platform if you want to load local shared
+libraries but not shared libraries from the install directory. If the
+shared library cache already contains the install directory, the option
+should not have any useful effect. In OpenBSD, the shared library cache
+can be reordered to prefer directories for testing shared libraries over
+the directories already listed in the shared 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
