all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: myglc2 <myglc2@gmail.com>
To: guix-devel@gnu.org
Subject: [PATCH] doc: Explain when guix edit is read-only.
Date: Thu, 21 Jul 2016 18:35:34 -0400	[thread overview]
Message-ID: <cu7shv27h6x.fsf@gmail.com> (raw)


* 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!
 
 @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:
 
 @example
@@ -4494,9 +4494,15 @@ guix edit gcc@@4.9 vim
 
 @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.
 
+If you are using a Guix Git checkout (@pxref{Building from Git}), or
+have created your own packages on ‘GUIX_PACKAGE_PATH’ (*note Defining
+Packages::), you will be able to edit the package recipes. Otherwise,
+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
-- 
2.9.1

             reply	other threads:[~2016-07-21 22:37 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-07-21 22:35 myglc2 [this message]
2016-07-24  8:27 ` [PATCH] doc: Explain when guix edit is read-only Alex Kost
2016-07-24 17:06   ` Ludovic Courtès
2016-07-25 14:25     ` Alex Kost

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=cu7shv27h6x.fsf@gmail.com \
    --to=myglc2@gmail.com \
    --cc=guix-devel@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/guix.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.