Subject: Re: bug#62710: Man page of loginctl is invalid troff.
From: Maxim Cournoyer <[email-masked]>
To: Martin Castillo <[email-masked]>
Cc: [email-masked]
Date: Tue, 11 Apr 2023 21:59:46 -0400
List-Id: <debbugs-submit.debbugs.gnu.org>

Hi,

Martin Castillo <[email-masked]> writes:

> Hi,
>
> man loginctl prints stuff like
>
>   .SH "NAME" loginctl - Control the elogind login manager
>
>   .SH "SYNOPSIS"
>
>     .HP 216u
>
>       loginctl
>        [OPTIONS...]
>        {COMMAND}
>        [NAME...]
>
>     .PP /lib/elogind/system-shutdown
>
> Indeed zcat /run/current-system/profile/share/man/man1/loginctl.1.gz
> shows
> [...]
>   .SH "NAME"
> loginctl \- Control the elogind login manager
>
>
>   .SH "SYNOPSIS"
>
>     .HP \w'\fBloginctl\fR\ 'u
>
>       \fBloginctl\fR
>        [OPTIONS...]
>        {COMMAND}
>        [NAME...]
>
>
>
>     .PP
> /lib/elogind/system\-shutdown
>
> [...]
>
> i.e. .SH etc. are not at line beginnings and are not recognized by man.
>
> I'm using elogind-246.10:
> /gnu/store/7sq4qp09fl1pn72jw828ndm13nbpknhv-elogind-246.10/share/man/man1/loginctl.1.gz

That's due to a bug in the last release of docbook-xsl
(https://github.com/docbook/xslt10-stylesheets/issues/109).  It's fixed
on the core-updates branch by using an unreleased snapshot.  Since
elogind has 2953 dependents, we'll have to wait until this branch is
merged, which should be soon!

Closing.

-- 
Thanks,
Maxim