01/10: doc: Improve ‘fix-runpath’ description.

[Tobias Geerinckx-Rice]

nckx pushed a commit to branch master
in repository guix.

commit 782c94fe30268ef321dc32d313c96e33c4189b24
Author: Tobias Geerinckx-Rice <address@hidden>
Date:   Sat Jan 20 21:36:17 2018 +0100

    doc: Improve ‘fix-runpath’ description.
    
    * doc/guix.texi (Build Systems): Re-write ‘fix-runpath’ documentation
    entirely.  Just fixing the typos didn't do much.
---
 doc/guix.texi | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 58b9675..983e00a 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -40,7 +40,7 @@ Copyright @copyright{} 2017 Christopher Allan address@hidden
 Copyright @copyright{} 2017 Marius address@hidden
 Copyright @copyright{} 2017 Hartmut address@hidden
 Copyright @copyright{} 2017 Maxim address@hidden
-Copyright @copyright{} 2017 Tobias address@hidden
+Copyright @copyright{} 2017, 2018 Tobias address@hidden
 Copyright @copyright{} 2017 George address@hidden
 Copyright @copyright{} 2017 Andy address@hidden
 Copyright @copyright{} 2017 Arun address@hidden
@@ -4005,12 +4005,12 @@ Apart from that, the build system also adds the 
following phases:
 @table @code
 
 @item fix-runpath
-This phase tries to locate the local directories in the package being build,
-which has libraries that some of the binaries need.  If any are found, they 
will
-be added to the programs @code{RUNPATH}.  It is needed because
address@hidden keeps the @code{RUNPATH} of binaries and libraries from
-when they are build, but often that is not the @code{RUNPATH} we want.
-Therefor it is also shrinked to the minimum needed by the program.
+This phase ensures that all binaries can find the libraries they need.
+It searches for required libraries in subdirectories of the package being
+built, and adds those to @code{RUNPATH} where needed.  It also removes
+references to libraries left over from the build phase by
address@hidden, such as test dependencies, that aren't actually
+required for the program to run.
 
 @item glib-or-gtk-wrap
 This phase is the phase provided by @code{glib-or-gtk-build-system}, and it