all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: myglc2 <myglc2@gmail.com>
To: 22598@debbugs.gnu.org
Subject: bug#22598: 'info guix' fails on guixSD
Date: Mon, 08 Feb 2016 07:50:46 -0500	[thread overview]
Message-ID: <877fif8ixl.fsf@gmail.com> (raw)

'man guix' is quite likely the first thing a new user types. The man
page is a stub to 'info guix'...

GUIX(1)
[...]
       If the info and guix programs are properly installed  at  your
       site, the command

              info guix

       should give you access to the complete manual.

However, on guixSD, 'info guix' produces 'bash: info: command not
found'.

While this result is technically understandable, it does seem rather
user-unfriendly.

Work arounds (tested on guixSD) are ...

1    guix environment guix
     info guix

2    tell the user that if info doesn't work, install it.

But both of these seem like bad things to say on the first man page.

From a usability point of view, it would probably be best to include
info in the global guixSD packages.

SIDE THOUGHT:

I love reading and using info in emacs. However, I will do almost
anything to avoid having to use the actual info program. I expect many
potential guix users are the same, or, more likely, have never heard of
info.

To improve the "man-points-to-info" man strategy (which I fully support)
perhaps guixSD and guix should include a user-friendly info reader and
the man page should point to that.

             reply	other threads:[~2016-02-08 12:51 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-02-08 12:50 myglc2 [this message]
2016-02-08 22:49 ` bug#22598: 'info guix' fails on guixSD Ludovic Courtès

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=877fif8ixl.fsf@gmail.com \
    --to=myglc2@gmail.com \
    --cc=22598@debbugs.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.