84/182: doc: Add clarification on the '--source' build option.

[guix-commits]

kkebreau pushed a commit to branch wip-gnome-updates
in repository guix.

commit 69aec18dd5553316140bfff89036b1192d08dae8
Author: Florian Pelz <address@hidden>
Date:   Wed Nov 6 19:28:57 2019 +0100

    doc: Add clarification on the '--source' build option.
    
    Emphasize that what the '--source' build option downloads is
    insufficient for reproducing the packages.
    
    * doc/guix.texi (Additional Build Options): Explain more.
---
 doc/guix.texi | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 4df928e..27cb31d 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -8318,6 +8318,11 @@ The returned source tarball is the result of applying 
any patches and
 code snippets specified in the package @code{origin} (@pxref{Defining
 Packages}).
 
+Note that @command{guix build -S} compiles the sources only of the
+specified packages.  They do not include the sources of statically
+linked dependencies and by themselves are insufficient for reproducing
+the packages.
+
 @item --sources
 Fetch and return the source of @var{package-or-derivation} and all their
 dependencies, recursively.  This is a handy way to obtain a local copy