~ruther/guix-local

7ce216110cbb4015bfc4ae186f4a34d38481ce1b — Ludovic Courtès 10 years ago cc6ed47
doc: Add quote about running a monadic value.

* doc/guix.texi (The Store Monad): Add funny quote about "running" a monadic
  value.
1 files changed, 7 insertions(+), 2 deletions(-)

M doc/guix.texi
M doc/guix.texi => doc/guix.texi +7 -2
@@ 2762,8 2762,13 @@ omitted since it will take place implicitly, as we will see later
                               #$output)))
@end example

Calling the monadic @code{sh-symlink} has no effect.  To get the desired
effect, one must use @code{run-with-store}:
@c See
@c <https://syntaxexclamation.wordpress.com/2014/06/26/escaping-continuations/> 
@c for the funny quote.
Calling the monadic @code{sh-symlink} has no effect.  As someone once
said, ``you exit a monad like you exit a building on fire: by running''.
So, to exit the monad and get the desired effect, one must use
@code{run-with-store}:

@example
(run-with-store (open-connection) (sh-symlink))