From: Pan Xie <xiepan@skyguard.com.cn>
To: help-guix@gnu.org, guix-devel@gnu.org
Subject: Mandb does not include guix package man pages
Date: Wed, 13 Mar 2024 13:49:17 +0800 [thread overview]
Message-ID: <36d2bb47-0786-475d-87eb-ced11a059681@skyguard.com.cn> (raw)
Hello
I find this issue on both GuixSD and guix package manager on ArchLinux.
The problem is `man -k' can not find manpages installed by guix. I
believe the issue is caused by `mandb' does not include guix packages'
man pages when generating its index database.
Confirm sbcl is installed:
#+begin_example
[0]:root@guix03:~# guix package -I | grep sbcl
sbcl 2.4.0 out
/gnu/store/093cjg5472s8j8hjzi2as61cs4w3lwrf-sbcl-2.4.0
#+end_example
"man -k" can't find sbcl from its index database. But `manpath' has
the correct setting, thus `man -w' can locate the man page file
#+begin_example
[0]:root@guix03:~# man -k sbcl
sbcl: nothing appropriate.
[16]:root@guix03:~# man -w sbcl
/gnu/store/093cjg5472s8j8hjzi2as61cs4w3lwrf-sbcl-2.4.0/share/man/man1/sbcl.1.gz
[0]:root@guix03:~# manpath
/root/.guix-profile/share/man:/run/current-system/profile/share/man:/gnu/store/gjsxzcc0gqpz4lpbsrbidlnn5ij1lfm1-gzip-1.12/share/man:/gnu/store/g4wn6n3frwnjsay098mqgy046wxl4iym-coreutils-9.1/share/man
#+end_example
"MANPATH" environment variable is empty
#+begin_example
[0]:root@guix03:~# echo $MANPATH
#+end_example
Use `mandb' update the index database, with debug output
#+begin_example
[0]:root@guix03:~# mandb -d
From the config file
/gnu/store/w427xcp2628gg2wcxivvccw2pm2ijjk9-man-db-2.11.1/etc/man_db.conf:
Mandatory mandir `/usr/man'.
Mandatory mandir `/usr/share/man'.
Mandatory mandir `/usr/local/share/man'.
Path `/bin' mapped to mandir `/usr/share/man'.
Path `/usr/bin' mapped to mandir `/usr/share/man'.
Path `/sbin' mapped to mandir `/usr/share/man'.
Path `/usr/sbin' mapped to mandir `/usr/share/man'.
Path `/usr/local/bin' mapped to mandir `/usr/local/man'.
Path `/usr/local/bin' mapped to mandir `/usr/local/share/man'.
Path `/usr/local/sbin' mapped to mandir `/usr/local/man'.
Path `/usr/local/sbin' mapped to mandir `/usr/local/share/man'.
Path `/usr/X11R6/bin' mapped to mandir `/usr/X11R6/man'.
Path `/usr/bin/X11' mapped to mandir `/usr/X11R6/man'.
Path `/usr/games' mapped to mandir `/usr/share/man'.
Path `/opt/bin' mapped to mandir `/opt/man'.
Path `/opt/sbin' mapped to mandir `/opt/man'.
Global mandir `/usr/man', catdir `/var/cache/man/fsstnd'.
Global mandir `/usr/share/man', catdir `/var/cache/man'.
Global mandir `/usr/local/man', catdir `/var/cache/man/oldlocal'.
Global mandir `/usr/local/share/man', catdir `/var/cache/man/local'.
Global mandir `/usr/X11R6/man', catdir `/var/cache/man/X11R6'.
Global mandir `/opt/man', catdir `/var/cache/man/opt'.
Global mandir `/snap/man', catdir `/var/cache/man/snap'.
Added sections: `1', `n', `l', `8', `3', `0', `2', `3type', `5', `4',
`9', `6', `7'.
path directory /root/.guix-profile/bin is not in the config file
adding /root/.guix-profile/share/man to manpath
path directory /root/Projects/config/scripts is not in the config file
path directory /run/setuid-programs is not in the config file
path directory /root/.config/guix/current/bin is not in the config file
path directory /root/.guix-profile/bin is not in the config file
path directory /run/current-system/profile/bin is not in the config file
adding /run/current-system/profile/share/man to manpath
path directory /run/current-system/profile/sbin is not in the config file
path directory /gnu/store/gjsxzcc0gqpz4lpbsrbidlnn5ij1lfm1-gzip-1.12/bin
is not in the config file
adding
/gnu/store/gjsxzcc0gqpz4lpbsrbidlnn5ij1lfm1-gzip-1.12/share/man to manpath
path directory
/gnu/store/g4wn6n3frwnjsay098mqgy046wxl4iym-coreutils-9.1/bin is not in
the config file
adding
/gnu/store/g4wn6n3frwnjsay098mqgy046wxl4iym-coreutils-9.1/share/man to
manpath
adding mandatory man directories
warning: /usr/man: No such file or directory
warning: /usr/share/man: No such file or directory
warning: /usr/local/share/man: No such file or directory
warning: /usr/man: No such file or directory
warning: /usr/share/man: No such file or directory
warning: /usr/local/man: No such file or directory
warning: /usr/local/share/man: No such file or directory
warning: /usr/X11R6/man: No such file or directory
warning: /opt/man: No such file or directory
warning: /snap/man: No such file or directory
final search path =
0 man subdirectories contained newer manual pages.
0 manual pages were added.
0 stray cats were added.
0 old database entries were purged.
#+end_example
"man -k" still can't find sbcl from its database
#+begin_example
[0]:root@guix03:~# man -k sbcl
sbcl: nothing appropriate.
#+end_example
Please enlighten me how to include guix manpages into mandb. Will there
be improvement to guix's mandb to make it include manpages by default in
guix's future release?
Thanks
Pan
next reply other threads:[~2024-03-13 5:49 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-03-13 5:49 Pan Xie [this message]
2024-03-13 13:22 ` Mandb does not include guix package man pages Greg Hogan
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
List information: https://guix.gnu.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=36d2bb47-0786-475d-87eb-ced11a059681@skyguard.com.cn \
--to=xiepan@skyguard.com.cn \
--cc=guix-devel@gnu.org \
--cc=help-guix@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 public inbox
https://git.savannah.gnu.org/cgit/guix.git
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).