ryan77627/guix
1
0
Fork 0
mirror of https://git.in.rschanz.org/ryan77627/guix.git synced 2024-11-07 07:26:13 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: Merge "discourage use of texlive" with existing paragraph on "guix size"

Browse source 
* doc/contributing.texi (Submitting Patches): Merge "discourage use of
  texlive" with existing paragraph on "guix size".
This commit is contained in:
Pierre Neidhardt 2018-12-15 00:20:35 +01:00
parent 966629a114
commit 024e358cb9
No known key found for this signature in database
GPG key ID: 9BDCF497A4BBCC7F
1 changed files with 3 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
doc/contributing.texi
View file

@ -382,7 +382,9 @@ 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
whether to split the package (@pxref{Packages with Multiple Outputs}),
and which optional dependencies should be used.
and which optional dependencies should be used. In particular, avoid adding
@command{texlive} as a dependency: because of its extreme size, use
@command{texlive-tiny} or @command{texlive-union} instead.
@item
For important changes, check that dependent package (if applicable) are
@ -477,16 +479,6 @@ often better to clone the repository. Don't use the @command{name} field in
the URL: it is not very useful and if the name changes, the URL will probably
be wrong.
@item
Try to minimize the weight of the inputs to make the transitive closure as
small as possible (@pxref{Invoking guix size}). Use @command{native-inputs}
and @command{inputs} appropriately. It's sometimes sufficient to use the
@command{-minimal} version of a package as input, e.g. @command{bash-minimal}
instead of @command{bash}. In particular, avoid adding @command{texlive} as a
dependency: because of its extreme size, it's both heavy on the build farms
and on the users who would like to build or hack the package from source. Use
@command{texlive-tiny} or @command{texlive-union} instead.
@end enumerate
When posting a patch to the mailing list, use @samp{[PATCH] @dots{}} as