From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:46798) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1d6Y5u-0006HG-6Y for guix-patches@gnu.org; Fri, 05 May 2017 03:56:07 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1d6Y5q-00058h-B7 for guix-patches@gnu.org; Fri, 05 May 2017 03:56:06 -0400 Received: from debbugs.gnu.org ([208.118.235.43]:57145) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1d6Y5q-00058d-79 for guix-patches@gnu.org; Fri, 05 May 2017 03:56:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1d6Y5q-0007z6-09 for guix-patches@gnu.org; Fri, 05 May 2017 03:56:02 -0400 Subject: bug#26733: document (list package output) in operating-system-packages Resent-Message-ID: From: ludo@gnu.org (Ludovic =?UTF-8?Q?Court=C3=A8s?=) References: <20170501155155.673dd708@lepiller.eu> <87vapgh255.fsf@openmailbox.org> Date: Fri, 05 May 2017 09:55:04 +0200 In-Reply-To: <87vapgh255.fsf@openmailbox.org> (Kei Kebreau's message of "Thu, 04 May 2017 15:07:18 -0400") Message-ID: <87r303buw7.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+kyle=kyleam.com@gnu.org Sender: "Guix-patches" To: Kei Kebreau Cc: 26733@debbugs.gnu.org Kei Kebreau skribis: > Julien Lepiller writes: > >> Hi, >> >> here is a small patch to document how to make globally visible a >> specific output of a package. >> >>>>From 6a71d7613bbabdde9d43de5ff09601195f9f49ee Mon Sep 17 00:00:00 2001 >> From: Julien Lepiller >> Date: Mon, 1 May 2017 15:44:31 +0200 >> Subject: [PATCH] doc: Document (list package output) syntax in >> operanting-system-packages. >> >> * doc/guix.texi (Globally-Visible Packages): Document (PACKAGE OUTPUT) s= yntax. >> --- >> doc/guix.texi | 14 +++++++++++++- >> 1 file changed, 13 insertions(+), 1 deletion(-) >> >> diff --git a/doc/guix.texi b/doc/guix.texi >> index 957ce2bab..3ae9a1cd5 100644 >> --- a/doc/guix.texi >> +++ b/doc/guix.texi >> @@ -7678,7 +7678,19 @@ provides all the tools one would expect for basic= user and administrator >> tasks---including the GNU Core Utilities, the GNU Networking Utilities, >> the GNU Zile lightweight text editor, @command{find}, @command{grep}, >> etc. The example above adds tcpdump to those, taken from the @code{(gnu >> -packages admin)} module (@pxref{Package Modules}). >> +packages admin)} module (@pxref{Package Modules}). The >> +@code{(list package output)} syntax can be used to add a specific output >> +of a package: >> + >> +@lisp >> +(use-modules (gnu packages)) >> +(use-modules (gnu packages dns)) >> + >> +(operating-system >> + ;; ... >> + (packages (cons (list bind "utils") >> + %base-packages))) >> +@end lisp >>=20=20 >> @findex specification->package >> Referring to packages by variable name, like @var{tcpdump} above, has > > At first glance this change looks okay, but I'll wait for a second > opinion to be safe (I don't usually review documentation changes). LGTM too. Thanks, Ludo=E2=80=99.