[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[bug#30410] [PATCH 2/2] doc: Document the --manifest option for guix pac

From: myglc2
Subject: [bug#30410] [PATCH 2/2] doc: Document the --manifest option for guix pack.
Date: Mon, 12 Feb 2018 14:15:14 -0500
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.3 (gnu/linux)

Hi Konrad,

Very cool patch!

On 02/10/2018 at 12:35 Konrad Hinsen writes:

> +for use on machines that do not have Guix installed. Note that you can
> +specify @emph{either} a manifest file @emph{or} a list of packages,
> +but not both.

FWIW, here are a few thoughts ...

It would be helpful to add an example or two of "list of packages".

The term manifest has a few meanings in guix. There are the "input
manifests" forms accepted by '--manifest=' and the "output manifests"
produced by 'guix package' (e.g.,$HOME/.guix-profile/manifest). Only
input manifests are documented now. But ISTM there may eventually be a
tool to produce an input manifest from a user's profile that has grown
organically through install/remove operations. If/when that happens,
"output manifests" might also be mentioned in the doc.

Currently the doc doesn't show an actual manifest. Rather it shows 2
"input manifest" forms that are acceptable to '--manifest=' ...

          (use-package-modules guile emacs)
           (list emacs
                 ;; Use a specific package output.
                 (list guile-2.0 "debug")))

... and ...

           '("emacs" "address@hidden" "address@hidden:debug"))

These can be a source of confusion, typos, and error (or at least they
were to me). So I wonder: Does adding a 3rd "list of packages" form make
the option murkier? Would a separate option be simpler to document/use?

HTH - George

reply via email to

[Prev in Thread] Current Thread [Next in Thread]