FS#65829 - [man-pages] Excludes manpages not available in any other package

Attached to Project: Arch Linux
Opened by Jorge Luis Martinez Gomez (jol) - Saturday, 14 March 2020, 04:40 GMT
Last edited by Andreas Radke (AndyRTR) - Tuesday, 17 March 2020, 10:06 GMT
Task Type Bug Report
Category Packages: Core
Status Closed
Assigned To Andreas Radke (AndyRTR)
Architecture All
Severity Low
Priority Normal
Reported Version
Due in Version Undecided
Due Date Undecided
Percent Complete 100%
Votes 1
Private No

Details

Description:

I was looking for the section 7 manpages related to keyrings. The package man-pages excludes them with a note saying that they're included in the package keyutils. However, right now, the only manpages for section 7 in keyutils are "asymmetric-key" and "keyutils".

I also noticed that the mouse(4) manpage is missing from xf86-input-mouse. It only has a mousedrv(4) manpage. Perhaps the exclusion for that should also be removed. Ditto for attr(5) and lirc(4). They're not available in the attr and lirc packages, respectively. Also, bpf-helpers(7); the note says it's in the package bpf, but that package doesn't exist right now, and the manpage doesn't seem to be available in any other package.

Additional info:
* package version(s)
* config and/or log files etc.
* link to upstream bug report, if any

Steps to reproduce:
This task depends upon

Closed by  Andreas Radke (AndyRTR)
Tuesday, 17 March 2020, 10:06 GMT
Reason for closing:  Fixed
Additional comments about closing:  man-pages 5.05-2
Comment by Jorge Luis Martinez Gomez (jol) - Saturday, 14 March 2020, 04:43 GMT
Nevermind about bpf-helpers(7). I made a mistake on that when I checked.
Comment by freswa (frederik) - Saturday, 14 March 2020, 21:34 GMT
This is not a bug of the package man-pages, but every single package is responsible to ship the respective man page.
Could you please fill a separate bug-report per package where the man page is missing?

Thank you :)
Comment by freswa (frederik) - Sunday, 15 March 2020, 14:15 GMT
Commit msg from keyutils:
commit aedfce27baf51a776dc93e38b61df30eaee16003
Author: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Tue Dec 13 15:36:56 2016 +0100

man: Delete man pages that will migrate to the Linux man-pages project

As discussed face-to-face and by email, there are a number of
man pages in keyutils that document kernel APIs. The more natural
home for these pages is Linux man-pages. I've already migrated
the pages listed below into Linux man-pages, and subsequently
enhanced various pages. They'll be released with the next release of
man-pages (around the end of Feb 2017).

keyrings.7
persistent-keyring.7
process-keyring.7
session-keyring.7
thread-keyring.7
user-keyring.7
user-session-keyring.7

D man/keyrings.7
D man/persistent-keyring.7
D man/process-keyring.7
D man/session-keyring.7
D man/thread-keyring.7
D man/user-keyring.7
D man/user-session-keyring.7
Comment by Jorge Luis Martinez Gomez (jol) - Sunday, 15 March 2020, 17:04 GMT
freswa, thanks for reopening, but I'm curious. Why close the keyutils report, but not the attr and lirc ones, when they've also deleted the manpages from their repos for the same reason?
Comment by Jorge Luis Martinez Gomez (jol) - Sunday, 15 March 2020, 19:54 GMT
In the interest of keeping things interlinked for record-keeping, here are the other reports created from this one:

keyutils (closed)
https://bugs.archlinux.org/task/65838

attr
https://bugs.archlinux.org/task/65839

lirc
https://bugs.archlinux.org/task/65840
Comment by Jorge Luis Martinez Gomez (jol) - Sunday, 15 March 2020, 20:08 GMT
xf86-input-mouse no longer exists, so I didn't make a report for it.

Interestingly, the mouse(4) conflict (that once was) seems to have been for 2 different manpages (different content). I have xf86-input-mouse installed from when it still existed, and it seems to be an alias for mousedrv(4). That is, `man 4 mouse` gives me the same manpage as `man 4 mousedrv`, and it's different from the manpage that this man-pages package (the upstream not the Archlinux one) provides, which is this one:

http://man7.org/linux/man-pages/man4/mouse.4.html

Now, I don't *have* /usr/share/man/man4/mouse.4.gz, despite `man 4 mouse` working, so it *wouldn't* have been a file conflict even when xf86-input-mouse existed.

One might notice also that the manpage mouse(4) that the upstream of this package provides is related to the kernel and *not* to X11.

Loading...