all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Alex Kost <alezost@gmail.com>
To: myglc2 <myglc2@gmail.com>
Cc: help-guix@gnu.org
Subject: Re: guix-edit  shows "Autodoc not available..." w/ 2 REPLs
Date: Fri, 15 Jul 2016 20:31:37 +0300	[thread overview]
Message-ID: <87poqex0xy.fsf@gmail.com> (raw)
In-Reply-To: cu7h9btcc1s.fsf@gmail.com

myglc2 (2016-07-14 03:12 +0300) wrote:

> Alex Kost <alezost@gmail.com> writes:
>
>> myglc2 (2016-07-12 17:22 +0300) wrote:
[...]
>>> Would it make sense to add this info to the doc?
>>
>> Sorry, what info do you mean?
>
> I mean add an explanation along the lines of what your wrote above to
> the documentation.  Maybe in a background or how it works section.

OK, maybe someday :-)

[...]
>>> If so, would it be a helpful enhancement if guix-emacs started the 3rd
>>> REPL automatically?
>>
>> No!  This relates to a usual editing of .scm files.  When you open .scm
>> file, the Geiser REPL is not started automatically, and it shouldn't!  I
>> think this would be a malicious behavior.
>
> I don't understand why this would be malicious. Could you explain?

When I open ".py" file, the Python REPL is not started automatically,
when I open ".scm" file, the Geiser REPL should not be started
automatically, etc.  This is normal!  If you want to have such kind of
interactive programming, you need to start the REPL yourself.

>> It's up to a user to decide how (s)he wants to edit his/her files (in
>> this case: with or without a help of Geiser).
>
> Agreed. But I would prefer for Guix by default to start the REPL and
> provide a way for me to disable this behavior if I like ;-)

No!  You want to break a normal behavior.  REPLs are not started
automatically when you open a file for editing.

> In general, I think it would be better for commands like 'C-c . l' to
> work instead of: beeping and giving the message "or: Geiser REPL not
> found". Such messages tend to give the first impression that something
> is not working properly :-(

Then running "C-x C-e" (geiser-eval-last-sexp) in .scm buffer should
give you the same impression, as it gives the same error if REPL is not
running.

This is normal, and I mean not only for Guix or for Geiser, but for
these kinds of interactive programming (using REPLs) in Emacs.

BTW I think this Geiser error is quite informative as it tells you what
to do.

> In general, if there are commands that don't work in a vanilla install,
> the doc should indicate that they don't work without additional
> setup/action, what that setup/action is, and what a user sees if that
> setup/action has not been done.

The commands work in vanilla install!  All you need is "M-x run-geiser"
as the Geiser error tells.  But the documentation can always be improved
of course.

I think you are just not used to editing files using REPLs.  Did you
ever use Geiser or SLIME or other REPLs in Emacs before?

-- 
Alex

  reply	other threads:[~2016-07-15 17:31 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-07-11 15:09 guix-edit shows "Autodoc not available..." w/ 2 REPLs myglc2
2016-07-12  8:16 ` Alex Kost
2016-07-12 14:22   ` myglc2
2016-07-12 20:56     ` Alex Kost
2016-07-14  0:12       ` myglc2
2016-07-15 17:31         ` Alex Kost [this message]
2016-07-16 15:07           ` myglc2
2016-07-19 17:54             ` Alex Kost
2016-07-19 21:18               ` myglc2
2016-07-18 13:05         ` myglc2
2016-07-19 16:39           ` 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=87poqex0xy.fsf@gmail.com \
    --to=alezost@gmail.com \
    --cc=help-guix@gnu.org \
    --cc=myglc2@gmail.com \
    /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.