Skip to content
Snippets Groups Projects
Unverified Commit 2fd345cd authored by Ludovic Courtès's avatar Ludovic Courtès
Browse files

doc: Improve 'guix size' documentation.

Suggested by Martin Castillo <castilma@uni-bremen.de>.
Fixes <https://bugs.gnu.org/31456>.

* doc/guix.texi (Invoking guix size): Clarify that 'guix size' looks for
ungrafted packages.  Clarify that it can be passed several package
specifications.
parent 5f93600f
No related branches found
No related tags found
No related merge requests found
...@@ -6905,7 +6905,8 @@ single output for a package that could easily be split (@pxref{Packages ...@@ -6905,7 +6905,8 @@ single output for a package that could easily be split (@pxref{Packages
with Multiple Outputs}). Such are the typical issues that with Multiple Outputs}). Such are the typical issues that
@command{guix size} can highlight. @command{guix size} can highlight.
   
The command can be passed a package specification such as @code{gcc@@4.8} The command can be passed one or more package specifications
such as @code{gcc@@4.8}
or @code{guile:debug}, or a file name in the store. Consider this or @code{guile:debug}, or a file name in the store. Consider this
example: example:
   
...@@ -6941,13 +6942,16 @@ In this example, we see that the closure of Coreutils weighs in at ...@@ -6941,13 +6942,16 @@ In this example, we see that the closure of Coreutils weighs in at
large fraction of the closure is not a problem @i{per se} because it is large fraction of the closure is not a problem @i{per se} because it is
always available on the system anyway.) always available on the system anyway.)
   
When the package passed to @command{guix size} is available in the When the package(s) passed to @command{guix size} are available in the
store, @command{guix size} queries the daemon to determine its store@footnote{More precisely, @command{guix size} looks for the
@emph{ungrafted} variant of the given package(s), as returned by
@code{guix build @var{package} --no-grafts}. @xref{Security Updates},
for information on grafts.}, @command{guix size} queries the daemon to determine its
dependencies, and measures its size in the store, similar to @command{du dependencies, and measures its size in the store, similar to @command{du
-ms --apparent-size} (@pxref{du invocation,,, coreutils, GNU -ms --apparent-size} (@pxref{du invocation,,, coreutils, GNU
Coreutils}). Coreutils}).
   
When the given package is @emph{not} in the store, @command{guix size} When the given packages are @emph{not} in the store, @command{guix size}
reports information based on the available substitutes reports information based on the available substitutes
(@pxref{Substitutes}). This makes it possible it to profile disk usage of (@pxref{Substitutes}). This makes it possible it to profile disk usage of
store items that are not even on disk, only available remotely. store items that are not even on disk, only available remotely.
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment