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
next 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.