GNU bug report logs - #59712
[DOCUMENTATION] [PATCH] doc: Suggest guile-readline and guile-colorized.

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 59712 in the body.
You can then email your comments to 59712 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: mirai <at> makinata.eu
To: guix-patches <at> gnu.org
Cc: Bruno Victal <mirai <at> makinata.eu>
Subject: [PATCH] doc: Suggest guile-readline and guile-colorized.
Date: Wed, 30 Nov 2022 02:23:08 +0000

From: Bruno Victal <mirai <at> makinata.eu>

Allows for a smoother experience with './pre-inst-env guix repl'.

* doc/contributing.texi (Building from Git): Suggest guile-readline and guile-colorized.
---
 doc/contributing.texi | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 40ae33ecac..b5831c5474 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -96,7 +96,7 @@ On Guix, extra dependencies can be added by instead running @command{guix
 shell}:
 
 @example
-guix shell -D guix help2man git strace --pure
+guix shell -D guix help2man git strace guile-readline guile-colorized --pure
 @end example
 
 From there you can generate the build system infrastructure

base-commit: aaf1f18b8044142515ff868bcbd2b72b81ced3ec
-- 
2.38.1

Message #8 received at 59712 <at> debbugs.gnu.org (full text, mbox):

From: zimoun <zimon.toutoune <at> gmail.com>
To: mirai <at> makinata.eu, 59712 <at> debbugs.gnu.org
Cc: Bruno Victal <mirai <at> makinata.eu>
Subject: Re: [bug#59712] [PATCH] doc: Suggest guile-readline and
 guile-colorized.
Date: Wed, 30 Nov 2022 09:37:36 +0100

Hi,

On Wed, 30 Nov 2022 at 02:23, mirai <at> makinata.eu wrote:

> +guix shell -D guix help2man git strace guile-readline guile-colorized --pure

The package guile-readline requires to be activated, no?
For guile-colorized, never used. :-)

On one hand, I agree that smoothing the experience with “guix repl” is
worth.  On the other hand, I think it better to reduce the barrier by
suggesting out-of-the-box packages in the Contributing section.

Well, instead, I am proposing to put this recommendation in this other
section (guix) The Perfect Setup.  For example, better worded :-)

--8<---------------cut here---------------start------------->8---
The Perfect Setup to hack on Guix is basically the perfect setup used
for Guile hacking (*note (guile)Using Guile in Emacs::).  First, the
experience is smooth when the packages guile-readline and
guile-colorized are installed and configured.  We recommend this
~/.guile,

    (use-modules
     (ice-9 readline)
     (ice-9 format)
     (ice-9 pretty-print))
    (activate-readline)

Then, you need more than an editor, you need Emacs
(https://www.gnu.org/software/emacs), empowered by the wonderful Geiser
(https://nongnu.org/geiser/).  To set that up, run:
--8<---------------cut here---------------end--------------->8---


WDYT?

Cheers,
simon

Message #11 received at 59712 <at> debbugs.gnu.org (full text, mbox):

From: mirai <mirai <at> makinata.eu>
To: zimoun <zimon.toutoune <at> gmail.com>, 59712 <at> debbugs.gnu.org
Subject: Re: [bug#59712] [PATCH] doc: Suggest guile-readline and
 guile-colorized.
Date: Wed, 30 Nov 2022 12:11:05 +0000

On 2022-11-30 08:37, zimoun wrote:
> The package guile-readline requires to be activated, no?

Right.

> For guile-colorized, never used. 😄

For guile-colorized, it's automatic.

> Well, instead, I am proposing to put this recommendation in this other
> section (guix) The Perfect Setup.  For example, better worded 😄

I'd say that both your snippet and the package recommendations should
be added else one would end up wondering why their './pre-inst-env guix repl'
doesn't pick up the guile extensions when doing so from the guix shell.


Thoughts?

Cheers,
Bruno

Message #14 received at 59712 <at> debbugs.gnu.org (full text, mbox):

From: mirai <mirai <at> makinata.eu>
To: zimoun <zimon.toutoune <at> gmail.com>, 59712 <at> debbugs.gnu.org
Subject: Re: [bug#59712] [PATCH] doc: Suggest guile-readline and
 guile-colorized.
Date: Fri, 2 Dec 2022 18:59:54 +0000

I've noticed that 9.14 "Using Guix Interactively"[1] already makes this recommendation.

[1]: https://guix.gnu.org/en/manual/devel/en/html_node/Using-Guix-Interactively.html#Using-Guix-Interactively

On 2022-11-30 08:37, zimoun wrote:
> Hi,
> 
> On Wed, 30 Nov 2022 at 02:23, mirai <at> makinata.eu wrote:
> 
>> +guix shell -D guix help2man git strace guile-readline guile-colorized --pure
> 
> The package guile-readline requires to be activated, no?
> For guile-colorized, never used. :-)
> 
> On one hand, I agree that smoothing the experience with “guix repl” is
> worth.  On the other hand, I think it better to reduce the barrier by
> suggesting out-of-the-box packages in the Contributing section.
> 
> Well, instead, I am proposing to put this recommendation in this other
> section (guix) The Perfect Setup.  For example, better worded :-)
> 
> --8<---------------cut here---------------start------------->8---
> The Perfect Setup to hack on Guix is basically the perfect setup used
> for Guile hacking (*note (guile)Using Guile in Emacs::).  First, the
> experience is smooth when the packages guile-readline and
> guile-colorized are installed and configured.  We recommend this
> ~/.guile,
> 
>     (use-modules
>      (ice-9 readline)
>      (ice-9 format)
>      (ice-9 pretty-print))
>     (activate-readline)
> 
> Then, you need more than an editor, you need Emacs
> (https://www.gnu.org/software/emacs), empowered by the wonderful Geiser
> (https://nongnu.org/geiser/).  To set that up, run:
> --8<---------------cut here---------------end--------------->8---
> 
> 
> WDYT?
> 
> Cheers,
> simon

Message #19 received at 59712 <at> debbugs.gnu.org (full text, mbox):

From: Ludovic Courtès <ludo <at> gnu.org>
To: mirai <at> makinata.eu
Cc: Simon Tournier <zimon.toutoune <at> gmail.com>, 59712 <at> debbugs.gnu.org
Subject: Re: bug#59712: [DOCUMENTATION] [PATCH] doc: Suggest guile-readline
 and guile-colorized.
Date: Wed, 14 Dec 2022 12:39:22 +0100

Hi!

mirai <at> makinata.eu skribis:

> From: Bruno Victal <mirai <at> makinata.eu>
>
> Allows for a smoother experience with './pre-inst-env guix repl'.
>
> * doc/contributing.texi (Building from Git): Suggest guile-readline and guile-colorized.

Is this the right place?  Currently both are recommended under “Using
Guix Interactively”, which I think is more appropriate.  But maybe we
should add a cross-reference?

To complement what zimoun wrote, the ‘.guile’ skeleton (that new home
directories get by default) enables both when they’re installed.

All in all, I’m not sure anything’s missing.  WDYT?

Ludo’.

Message #22 received at 59712 <at> debbugs.gnu.org (full text, mbox):

From: zimoun <zimon.toutoune <at> gmail.com>
To: mirai <mirai <at> makinata.eu>, 59712 <at> debbugs.gnu.org
Subject: Re: [bug#59712] [PATCH] doc: Suggest guile-readline and
 guile-colorized.
Date: Wed, 14 Dec 2022 14:33:42 +0100

Hi,

On Fri, 02 Dec 2022 at 18:59, mirai <mirai <at> makinata.eu> wrote:
> I've noticed that 9.14 "Using Guix Interactively"[1] already makes this recommendation.

Therefore, maybe just a cross-reference will be enough but I do not know
where it seems a good place.  WDYT?

Cheers,
simon

Message #25 received at 59712 <at> debbugs.gnu.org (full text, mbox):

From: mirai <mirai <at> makinata.eu>
To: Ludovic Courtès <ludo <at> gnu.org>
Cc: Simon Tournier <zimon.toutoune <at> gmail.com>, 59712 <at> debbugs.gnu.org
Subject: Re: bug#59712: [DOCUMENTATION] [PATCH] doc: Suggest guile-readline
 and guile-colorized.
Date: Wed, 28 Dec 2022 17:28:45 +0000

On 2022-12-14 11:39, Ludovic Courtès wrote:
> Hi!
> 
> mirai <at> makinata.eu skribis:
> 
>> From: Bruno Victal <mirai <at> makinata.eu>
>>
>> Allows for a smoother experience with './pre-inst-env guix repl'.
>>
>> * doc/contributing.texi (Building from Git): Suggest guile-readline and guile-colorized.
> 
> Is this the right place?  Currently both are recommended under “Using
> Guix Interactively”, which I think is more appropriate.  But maybe we
> should add a cross-reference?
> 
> To complement what zimoun wrote, the ‘.guile’ skeleton (that new home
> directories get by default) enables both when they’re installed.
> 
> All in all, I’m not sure anything’s missing.
--8<---------------cut here---------------start------------->8---
# have both guile-colorized or guile-readline already installed either via config.scm or guix install

$ guix shell -D guix help2man git strace --pure
~/src/guix [env]$

# perform ./bootstrap, configure and make

~/src/guix [env]$ ./pre-inst-env guix repl
scheme@(guix-user)> ;; does not have guile-colorized or guile-readline

--8<---------------cut here---------------end--------------->8---


The inconvenient part here being having to do:

--8<---------------cut here---------------start------------->8---
CTRL-D
$ guix shell -D guix help2man git strace guile-colorized guile-readline --pure
~/src/guix [env]$

# continue with whatever task was being done before

--8<---------------cut here---------------end--------------->8---

Message #28 received at 59712 <at> debbugs.gnu.org (full text, mbox):

From: zimoun <zimon.toutoune <at> gmail.com>
To: mirai <mirai <at> makinata.eu>, Ludovic Courtès <ludo <at> gnu.org>
Cc: 59712 <at> debbugs.gnu.org
Subject: Re: [bug#59712] [DOCUMENTATION] [PATCH] doc: Suggest guile-readline
 and guile-colorized.
Date: Fri, 30 Dec 2022 15:37:34 +0100

Hi,

On Wed, 28 Dec 2022 at 17:28, mirai <mirai <at> makinata.eu> wrote:
> On 2022-12-14 11:39, Ludovic Courtès wrote:
>> Hi!
>> 
>> mirai <at> makinata.eu skribis:
>> 
>>> From: Bruno Victal <mirai <at> makinata.eu>
>>>
>>> Allows for a smoother experience with './pre-inst-env guix repl'.
>>>
>>> * doc/contributing.texi (Building from Git): Suggest guile-readline and guile-colorized.
>> 
>> Is this the right place?  Currently both are recommended under “Using
>> Guix Interactively”, which I think is more appropriate.  But maybe we
>> should add a cross-reference?
>> 
>> To complement what zimoun wrote, the ‘.guile’ skeleton (that new home
>> directories get by default) enables both when they’re installed.
>> 
>> All in all, I’m not sure anything’s missing.
> --8<---------------cut here---------------start------------->8---
> # have both guile-colorized or guile-readline already installed either via config.scm or guix install
>
> $ guix shell -D guix help2man git strace --pure
> ~/src/guix [env]$
>
> # perform ./bootstrap, configure and make
>
> ~/src/guix [env]$ ./pre-inst-env guix repl
> scheme@(guix-user)> ;; does not have guile-colorized or guile-readline
>
> --8<---------------cut here---------------end--------------->8---
>
>
> The inconvenient part here being having to do:
>
> --8<---------------cut here---------------start------------->8---
> CTRL-D
> $ guix shell -D guix help2man git strace guile-colorized guile-readline --pure
> ~/src/guix [env]$
>
> # continue with whatever task was being done before
>
> --8<---------------cut here---------------end--------------->8---

I agree with Ludo.  These guile-colorized and guile-readline
recommendations do not appear to me the right place.  As pointed in [1],
maybe I would add a cross-reference.

1: <https://yhetil.org/guix/86cz8mhzyh.fsf <at> gmail.com>


The command line for Building from Git is,

    guix shell -D guix --pure

Then, the manual reads: «On Guix, extra dependencies can be added by
instead running guix shell: 

    guix shell -D guix help2man git strace --pure

» so I would avoid to overload some extra recommendations here.
Especially when such recommendations require extra configuration.
Maybe a cross-link?

The aim of this section is to explain how to build from Git and it
appears to me better to keep it straight to the point and thus to avoid
too many unrelated details (how to configure “./pre-inst-env guix repl”
for instance).  The recommendations of guile-colorized and
guile-readline are about using Guix interactively; therefore it appears
to me better to recommend and explain in the dedicated section.


https://guix.gnu.org/manual/devel/en/guix.html#Building-from-Git
https://guix.gnu.org/manual/devel/en/guix.html#Using-Guix-Interactively


Cheers,
simon

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.