ryan77627/guix
1
0
Fork 0
mirror of https://git.in.rschanz.org/ryan77627/guix.git synced 2024-12-24 05:18:07 -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 (@pxref{Invoking guix size}). This will allow you to notice references
to other packages unwillingly retained. It may also help determine to other packages unwillingly retained. It may also help determine
whether to split the package (@pxref{Packages with Multiple Outputs}), 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 @item
For important changes, check that dependent package (if applicable) are 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 the URL: it is not very useful and if the name changes, the URL will probably
be wrong. 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 @end enumerate
When posting a patch to the mailing list, use @samp{[PATCH] @dots{}} as When posting a patch to the mailing list, use @samp{[PATCH] @dots{}} as