From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from eggs.gnu.org ([2001:4830:134:3::10]:36011)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1eloJg-00072Z-CI
	for guix-patches@gnu.org; Tue, 13 Feb 2018 23:05:09 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1eloJa-0003NJ-OY
	for guix-patches@gnu.org; Tue, 13 Feb 2018 23:05:08 -0500
Received: from debbugs.gnu.org ([208.118.235.43]:34157)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
	id 1eloJa-0003NC-Km
	for guix-patches@gnu.org; Tue, 13 Feb 2018 23:05:02 -0500
Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1eloJa-0006lD-8R
	for guix-patches@gnu.org; Tue, 13 Feb 2018 23:05:02 -0500
Subject: [bug#30410] [PATCH 2/2] doc: Document the --manifest option for guix
	pack.
Resent-Message-ID: <handler.30410.B30410.151858108225955@debbugs.gnu.org>
From: myglc2@gmail.com
References: <m1zi4hm4ta.fsf@ordinateur-de-catherine--konrad.home>
	<86r2pq81fh.fsf@gmail.com>
	<m1tvul2t8v.fsf@ordinateur-de-catherine--konrad.home>
Date: Tue, 13 Feb 2018 23:04:30 -0500
In-Reply-To: <m1tvul2t8v.fsf@ordinateur-de-catherine--konrad.home> (Konrad
	Hinsen's message of "Tue, 13 Feb 2018 09:23:12 +0100")
Message-ID: <86a7wcb4j5.fsf@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
List-Id: <guix-patches.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-patches>,
	<mailto:guix-patches-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/guix-patches/>
List-Post: <mailto:guix-patches@gnu.org>
List-Help: <mailto:guix-patches-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-patches>,
	<mailto:guix-patches-request@gnu.org?subject=subscribe>
Errors-To: guix-patches-bounces+kyle=kyleam.com@gnu.org
Sender: "Guix-patches" <guix-patches-bounces+kyle=kyleam.com@gnu.org>
To: Konrad Hinsen <konrad.hinsen@fastmail.net>
Cc: 30410@debbugs.gnu.org

On 02/13/2018 at 09:23 Konrad Hinsen writes:
Hi  Konrad,

> Hi George,
>
>> FWIW, here are a few thoughts ...
>>
>> It would be helpful to add an example or two of "list of packages".
>
> That basically means that my doc isn't clear enough :-(
>
> There is no special "list of packages". What I refer to is a command
> line with multiple package arguments, either package names or -e <Expr>
> arguments.
>
> The point is that "-m manifest.scm" and package-name or -e arguments
> are mutually exclusive.
>
> The problem I had with formulating this is that package-name arguments
> are never explicitly mentioned in the documentation, only options are
> documented. The only way to know that you can just list package names on
> the command line is looking at the examples.

Yeah, in the doc "list of packages" might mean a scheme list or "naming
one or more packages on the command line" or a =E2=80=9Cmanifest=E2=80=9D o=
bject (which
is roughly a list of packages) ;-) But maybe that's not your problem.

> Any idea of how to do this better?

I thought you were saying that --manifest would accept a manifest form
or a list of packages. But now I think I get it.

How about saying packages may be specified by the -m option or the -e
option or an explicit list of packages on the command line.

- or -

packages may be specified by only one of the following methods: the -m
option, the -e option, or an explicit list on the command line.

HTH - George