Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 764254 - sys-apps/systemd-246.6: man pages contain paths with /usr as root
Summary: sys-apps/systemd-246.6: man pages contain paths with /usr as root
Status: RESOLVED WONTFIX
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Gentoo systemd Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-01-07 09:04 UTC by Stefan Huber
Modified: 2022-09-16 02:11 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Stefan Huber 2021-01-07 09:04:55 UTC
The systemd root has been moved from /usr to / as tracked by bug #625954. However, the man page of systemd-suspend.service installed by systemd-246.6 mentions /usr/lib/systemd/system-sleep/, and hence still refers to the old /usr root.

This again may cause invalid bugs like #646716 when people follow to the man page documentation.

However, the same is true for other man pages as well, e.g., all systemd-*-generator man pages. I guess that all actually all man pages are affected:

$ cd /usr/share/man/man8
$ for f in systemd*.bz2; do bzcat $f | grep "[^r]/lib/systemd" && echo ">> $f"; done | wc -l
0
$ for f in systemd*.bz2; do bzcat $f | grep "/usr/lib/systemd" && echo ">> $f"; done | wc -l
131


I guess this bug also concerns systemd-246-r2 and maybe also 247.2-r4.

Reproducible: Always
Comment 1 Mike Gilbert gentoo-dev 2021-01-07 16:10:20 UTC
Upstream doesn't support having correct documentation. Sorry.

https://github.com/systemd/systemd/commit/12b42c76672a66c2d4ea7212c14f8f1b5a62b78d
Comment 2 Stefan Huber 2021-01-07 16:14:06 UTC
How come that Debian Buster ships correct paths in the man pages?
Comment 3 Mike Gilbert gentoo-dev 2021-01-07 16:17:27 UTC
They patch it.
Comment 4 Stefan Huber 2021-01-07 16:18:46 UTC
And why don't we?
Comment 5 Mike Gilbert gentoo-dev 2021-01-07 16:22:25 UTC
Maintaining such a patch seems like a pain.
Comment 6 Stefan Huber 2021-01-07 16:32:00 UTC
I really do not want to start an argument here, but maintaining bugs like bug #646716 seems to be a burden, too.

However, keeping wrong information in man pages appears to be fundamentally wrong to me and by far outweighs the debt caused by maintaining a patch, ultimately questioning whether this would not have actually blocked the rootprefix transition in the first place if the burden of having correct man pages turns out to be out of reach.
Comment 7 Mike Gilbert gentoo-dev 2021-01-07 17:20:57 UTC
I'll re-open the bug in case someone else wants to work on it.
Comment 8 Sam James archtester Gentoo Infrastructure gentoo-dev Security 2022-09-16 02:11:34 UTC
Note that this is obsolete given we're moving forward with merged-usr for systemd profiles by end of year hopefully.