~ruther/guix-local

d222522edf70cdac6cee7b4ab8fa1bfbf0a7ba9c — Ludovic Courtès 9 years ago 3a78fab
doc: Discourage software bundling.

Fixes <http://bugs.gnu.org/24008>.
Suggested by ng0 <ng0@we.make.ritual.n0.is>.

* doc/contributing.texi (Submitting Patches): Add item about bundling.
1 files changed, 14 insertions(+), 0 deletions(-)

M doc/contributing.texi
M doc/contributing.texi => doc/contributing.texi +14 -0
@@ 289,6 289,20 @@ Make sure the package builds on your platform, using @code{guix build
@var{package}}.

@item
@cindex bundling
Make sure the package does not use bundled copies of software already
available as separate packages.

Sometimes, packages include copies of the source code of their
dependencies as a convenience for users.  However, as a distribution, we
want to make sure that such packages end up using the copy we already
have in the distribution, if there is one.  This improves resource usage
(the dependency is built and stored only once), and allows the
distribution to make transverse changes such as applying security
updates for a given software package in a single place and have them
affect the whole system---something that bundled copies prevent.

@item
Take a look at the profile reported by @command{guix size}
(@pxref{Invoking guix size}).  This will allow you to notice references
to other packages unwillingly retained.  It may also help determine