Possible formatting bug in ssh-agent.1 man page

Jakub Jelen jjelen at redhat.com
Tue Sep 27 17:19:50 AEST 2016


On 09/26/2016 10:55 PM, Glenn Golden wrote:
> Version info: OpenSSH_7.3p1, OpenSSL 1.0.2i  22 Sep 2016, Arch linux
>
> The ssh-agent.1 man page seems to have an indentation oddity, at least, as
> formatted with recent Arch linux manpage toolset. Here's what appears in
> the formatted output just after the description of the the "-t" option:
>
>       ---------- Begin formatted output -------------------------------------
>         -t life
>                Set a default value for the maximum lifetime of identities added
>                to  the agent.  The lifetime may be specified in seconds or in a
>                time format specified in sshd_config(5).  A  lifetime  specified
>                for  an  identity with ssh-add(1) overrides this value.  Without
>                this option the default maximum lifetime is forever.
>
>                If a command line is given, this is executed as a subprocess  of
>                the agent.  When the command dies, so does the agent.
>
>                The  idea  is that the agent is run in the user's local PC, lap
>                        .
>                        .
>                        .
>       ------------ End formatted output -------------------------------------
>
> Seems to me like all the paragraphs after the one immediately below "-t life"
> (starting with "If a command line..." and thereafter) are meant to be outdented
> to the main indentation level so that they do not appear be associated with the
> description of the -t option.
The Fedora gets it correctly, both from 7.3p1 tarball and from upstream git.

Tested with man-db-2.7.5-3.fc24.x86_64 (not sure what other tools might 
involved in formatting).

-- 
Jakub Jelen
Associate Software Engineer
Security Technologies
Red Hat



More information about the openssh-unix-dev mailing list