all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / 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

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.