unofficial mirror of help-guix@gnu.org 
 help / color / mirror / Atom feed
* Location of Guix manpages in foreign distribution
@ 2024-01-26 15:26 Suhail
  0 siblings, 0 replies; 2+ messages in thread
From: Suhail @ 2024-01-26 15:26 UTC (permalink / raw)
  To: Help-Guix mailing list

Hello all,

When doing a binary installation via the [shell installer script] (with
possible updates via "sudo -i guix pull"), where are the manpages
installed?

The info pages are linked and accessible from
~/.config/guix/current/share/info/ , but there's no corresponding
~/.config/guix/current/share/man .

[shell installer script]: <https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh>

-- 
Suhail



^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: Location of Guix manpages in foreign distribution
       [not found] <310c3276-14c8-147d-8c3f-f05b4fd33730@mutix.org>
@ 2024-01-29  7:20 ` Suhail
  0 siblings, 0 replies; 2+ messages in thread
From: Suhail @ 2024-01-29  7:20 UTC (permalink / raw)
  To: Christina O'Donnell; +Cc: Help-Guix mailing list

"Christina O'Donnell" <cdo@mutix.org> writes:

> If I'm not mistaken, ~/.config/guix/ is only for the environment that Guix
> itself runs in.

Yes, and the specific manuals (manpages instead of info) I was looking
for were for the installed Guix version.  It's unclear if the manpages
for Guix were ever installed.  It's possible they were, but subsequent
updates through "sudo -i guix pull" didn't maintain them.

Upon digging some more, I realized that "guix" doesn't have an output
that only generates the manpages.  So doing something like "guix install
guix:manpages" was a no-go.  Additionally, even if something like that
had existed the version I would've gotten would have lagged behind the
Guix installed on the system.  Doing a "guix install guix" will get you
access to the Guix manpages, but will also override the system Guix with
a slightly older revision.  The latter being undesirable for my needs.

It turns out Guix, when built, generates the manpages via a tool called
help2man which generates manpages from the --help and --version output.
So a not-as-well-formatted alternative to something like "man guix-gc"
is simply to invoke "guix gc --help".  On Emacs, this can be made
slightly more user-friendly via [noman].

[noman]: <https://github.com/andykuszyk/noman.el>

-- 
Suhail



^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2024-01-29  7:21 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-01-26 15:26 Location of Guix manpages in foreign distribution Suhail
     [not found] <310c3276-14c8-147d-8c3f-f05b4fd33730@mutix.org>
2024-01-29  7:20 ` Suhail

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).