From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: [PATCH] doc: Explain when guix edit is read-only. Date: Sun, 24 Jul 2016 19:06:04 +0200 Message-ID: <87invvarur.fsf@gnu.org> References: <87lh0rcuf5.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:39489) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bRMr0-0002AM-0d for guix-devel@gnu.org; Sun, 24 Jul 2016 13:06:15 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bRMqu-0003TL-SF for guix-devel@gnu.org; Sun, 24 Jul 2016 13:06:12 -0400 In-Reply-To: <87lh0rcuf5.fsf@gmail.com> (Alex Kost's message of "Sun, 24 Jul 2016 11:27:42 +0300") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Alex Kost Cc: guix-devel@gnu.org, myglc2 Alex Kost skribis: > myglc2 (2016-07-22 01:35 +0300) wrote: > >> * doc/guix.texi (Invoking guix edit): Explain when you can and can't >> edit the recipe >> --- >> doc/guix.texi | 10 ++++++++-- >> 1 file changed, 8 insertions(+), 2 deletions(-) >> >> >> diff --git a/doc/guix.texi b/doc/guix.texi >> index e7b233d..914d24d 100644 >> --- a/doc/guix.texi >> +++ b/doc/guix.texi >> @@ -4485,7 +4485,7 @@ You can freely access a huge library of build logs! >>=20=20 >> @cindex package definition, editing >> So many packages, so many source files! The @command{guix edit} command >> -facilitates the life of packagers by pointing their editor at the source >> +facilitates the life of users and packagers by pointing their editor at= the source >> file containing the definition of the specified packages. For instance: >>=20=20 >> @example >> @@ -4494,9 +4494,15 @@ guix edit gcc@@4.9 vim >>=20=20 >> @noindent >> launches the program specified in the @code{VISUAL} or in the >> -@code{EDITOR} environment variable to edit the recipe of GCC@tie{}4.9.3 >> +@code{EDITOR} environment variable to view the recipe of GCC@tie{}4.9.3 >> and that of Vim. >>=20=20 >> +If you are using a Guix Git checkout (@pxref{Building from Git}), or >> +have created your own packages on =E2=80=98GUIX_PACKAGE_PATH=E2=80=99 (= *note Defining >> +Packages::), you will be able to edit the package recipes. Otherwise, Looks Info syntax here. Should be =E2=80=9C@code{GUIX_PACKAGE_PATH} (@pxref{Package Modules})=E2=80=9D? >> +you will be able to examine the read-only recipes for packages currently >> +in the store. >> + >> If you are using Emacs, note that the Emacs user interface provides the >> @kbd{M-x guix-edit} command and a similar functionality in the ``package >> info'' and ``package list'' buffers created by the @kbd{M-x > > This looks reasonable to me, so if there are no comments/objections, I'm > going to commit it. Sounds good to me. Thanks, Ludo=E2=80=99.