[warning] Unexpected final line in man document SYSTEMD-HWDB(8)

[mattia-b89]

This is a very low issue.
When I open man page of systemd-hwdb with GNOME's yelp,
journalctl reports this:

Apr 24 10:24:20 arch-xps yelp[8504]: Unexpected final line in man document (systemd 250                                                    SYSTEMD-HWDB(8))

NB: you can open the man document directly after $ systemd-hwdb --help or using direct command $ yelp "man:systemd-hwdb(8)"

---

• Arch Linux
• systemd-250.4-2

[mrc0mmand]

This seems to be caused by yelp expecting the last line to be in a format of <version> <date> <man_ref> and the systemd man pages don't have the date part, see https://gitlab.gnome.org/GNOME/yelp/-/blob/master/libyelp/yelp-man-parser.c#L1214-1222.

That makes me wonder - why we skip the date part when generating systemd-related man pages?

[mattia-b89]

To make it reproducible?

…

On Sun, 24 Apr 2022, 10:58 Frantisek Sumsal, ***@***.***> wrote: This seems to be caused by yelp expecting the last line to be in a format of <version> <date> <man_ref> and the systemd man pages don't have the date part, see https://gitlab.gnome.org/GNOME/yelp/-/blob/master/libyelp/yelp-man-parser.c#L1214-1222 . That makes me wonder - why we skip the date part when generating systemd-related man pages? — Reply to this email directly, view it on GitHub <#23184 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAEFFN66G2CAD2LNXO4XNY3VGUEKLANCNFSM5UF5PNQA> . You are receiving this because you authored the thread.Message ID: ***@***.***>

[mrc0mmand]

To make it reproducible?

That would certainly make sense, but it should be resolvable by using $SOURCE_DATE_EPOCH.

[mattia-b89]

I do not know how this variable works... (I am not an expert of repro-builds...)
Anyway, let's see if it is the problem appears in other distros too, since Arch Linux does not look like to alter man files after compilation.
Here [https://github.com/archlinux/svntogit-packages/blob/packages/systemd/trunk/PKGBUILD] is the PKGBUILD file.

[poettering]

I think the date at the bottom of the man pages is pretty useless. But if somebody preps a patch to insert $SOURCE_DATE_EPOCH there I'd be fine. Might make sense to make gnome's yelp deal with this natively however.

[poettering]

I think it would be nicer if yelp would just be able to handle man pages like this. Hence I filed:

https://gitlab.gnome.org/GNOME/yelp/-/issues/216