GNU bug report logs - #62710
Man page of loginctl is invalid troff.

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 62710 in the body.
You can then email your comments to 62710 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Martin Castillo <castilma <at> uni-bremen.de>
To: bug-guix <at> gnu.org
Subject: Man page of loginctl is invalid troff.
Date: Fri, 7 Apr 2023 14:08:34 +0200

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

Martin

Message #10 received at 62710-done <at> debbugs.gnu.org (full text, mbox):

From: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
To: Martin Castillo <castilma <at> uni-bremen.de>
Cc: 62710-done <at> debbugs.gnu.org
Subject: Re: bug#62710: Man page of loginctl is invalid troff.
Date: Tue, 11 Apr 2023 21:59:46 -0400

Hi,

Martin Castillo <castilma <at> uni-bremen.de> 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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.