Re: Problems in nmcli.1, nm-connection-editor.1

[Dan Williams <dcbw redhat com>]

On Tue, 2013-06-18 at 01:13 -0400, esr thyrsus com wrote:
> This is automatically generated email about markup problems in a man
> page for which you appear to be responsible.  If you are not the right
> person or list, please tell me so I can correct my database.
>
> See http://catb.org/~esr/doclifter/bugs.html for details on how and
> why these patches were generated.  Feel free to email me with any
> questions.  Note: These patches do not change the modification date of
> any manual page.  You may wish to do that by hand.
>
> I apologize if this message seems spammy or impersonal. The volume of
> markup bugs I am tracking is over five hundred - there is no real
> alternative to generating bugmail from a database and template.

I know this is auto-generated, but replying with an update.  The nmcli
issue is already fixed in git, but I applied and pushed the change for
nm-connection-editor.

Thanks,
Dan

> --
>                              Eric S. Raymond
> Problems with nmcli.1:
>
> Missing or garbled name section.  The most common form of garbling
> is a missing - or extra -. Or your manual page may have been generated
> by a tool that doesn't emit a NAME section as it should.  Or your page
> may add running text such as a version or authorship banner.  These
> problems make it impossible to lift the page to DocBook.  They
> can also confuse third-party manpage browsers and some implementations
> of man -k.
>
> Unknown or invalid macro.  That is, one that does not fit in the
> macro set that the man page seems to be using.  This is a serious
> error; it often means part of your text is being lost or rendered
> incorrectly.
>
> --- nmcli.1-unpatched 2013-05-24 17:08:58.597822819 -0400
> +++ nmcli.1   2013-05-24 17:09:18.841822440 -0400
> @@ -24,7 +24,7 @@
>  .TH NMCLI "1" "17 January 2013"
>  
>  .SH NAME
> -nmcli \(en command\(hyline tool for controlling NetworkManager
> +nmcli \- command\(hyline tool for controlling NetworkManager
>  .SH SYNOPSIS
>  .ad l
>  .B nmcli
> @@ -531,5 +531,5 @@
>  .BR nm\-online (1),
>  .BR NetworkManager (8),
>  .BR nm\-settings (5),
> -.BR nm\applet (1),
> +.BR nm\-applet (1),
>  .BR nm\-connection\-editor (1).
> Problems with nm-connection-editor.1:
>
> Missing or garbled name section.  The most common form of garbling
> is a missing - or extra -. Or your manual page may have been generated
> by a tool that doesn't emit a NAME section as it should.  Or your page
> may add running text such as a version or authorship banner.  These
> problems make it impossible to lift the page to DocBook.  They
> can also confuse third-party manpage browsers and some implementations
> of man -k.
>
> Unknown or invalid macro.  That is, one that does not fit in the
> macro set that the man page seems to be using.  This is a serious
> error; it often means part of your text is being lost or rendered
> incorrectly.
>
> --- nm-connection-editor.1-unpatched  2013-05-24 05:00:53.058639796 -0400
> +++ nm-connection-editor.1    2013-05-24 05:01:06.930639536 -0400
> @@ -24,7 +24,7 @@
>  .TH NM-CONNECTION-EDITOR "1" "15 February 2013"
>  
>  .SH NAME
> -nm\-connection\-editor \(en network connection editor for NetworkManager
> +nm\-connection\-editor \- network connection editor for NetworkManager
>  .SH SYNOPSIS
>  .B nm\-connection\-editor
>  .RI " [ " OPTIONS " ]
> _______________________________________________
> networkmanager-list mailing list
> networkmanager-list gnome org
> https://mail.gnome.org/mailman/listinfo/networkmanager-list