Problems in nmcli.1

[esr thyrsus com]

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.

--
                             Eric S. Raymond

Problems with nmcli.1:

Broken command synopsis syntax.  This may mean you're using a
construction in the command synopsis other than the standard
[ ] | { }, or it may mean you have running text in the command synopsis
section (the latter is not technically an error, but most cases of it
are impossible to translate into DocBook markup), or it may mean the
command syntax fails to match the description.

List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
Common causes include .TP just before a section header, .TP entries
with tags but no bodies, and mandoc lists with no trailing .El.
These confuse doclifter, and may also mess up stricter man-page
browsers like Xman and Rosetta.

Presentation-level use of SS could not be structurally
translated. I changed lower-level instances to .TP or .B.

--- nmcli.1-unpatched   2016-03-02 01:49:37.245643661 -0500
+++ nmcli.1     2016-03-02 01:49:47.477617367 -0500
@@ -26,40 +26,29 @@
 .SH NAME
 nmcli \- command\(hyline tool for controlling NetworkManager
 .SH SYNOPSIS
-.ad l
 .B nmcli
-.RI " [ " OPTIONS " ] " OBJECT " { " COMMAND " | "
-.BR help " } "
-.sp
-
-.IR OBJECT " := { "
-.BR general " | " networking " | " radio " | " connection " | " device " | " agent
-.RI " }"
-.sp
-
-.IR OPTIONS " := { "
-.br
-\fB\-t\fR[\fIerse\fR]
-.br
-\fB\-p\fR[\fIretty\fR]
-.br
-\fB\-m\fR[\fImode\fR] tabular | multiline
-.br
-\fB\-f\fR[\fIields\fR] <field1,field2,...> | all | common
-.br
-\fB\-e\fR[\fIscape\fR] yes | no
-.br
-\fB\-n\fR[\fIocheck\fR]
 .br
-\fB\-a\fR[\fIsk\fR]
+[
+\fB\-terse\fR |
+\fB\-pretty\fR |
+\fB\-mmode\fR { tabular | multiline } |
+.br
+\fB\-fields\fR { <field1,field2,...> | all | common } |
+\fB\-escape\fR { yes | no } |
+.br
+\fB\-nocheck\fR |
+\fB\-ask\fR |
+\fB\-wait\fR <seconds> |
+\fB\-version\fR |
+\fB\-help\fR
+]
 .br
-\fB\-w\fR[\fIait\fR] <seconds>
-.br
-\fB\-v\fR[\fIersion\fR]
-.br
-\fB\-h\fR[\fIelp\fR]
+{
+.BR general " | " networking " | " radio " | " connection " | " device " | " agent
+}
 .br
-.RI "}"
+.RI "{ " COMMAND " | "
+.BR help " } "
 
 .SH DESCRIPTION
 .B nmcli
@@ -153,7 +142,7 @@
 Use this object to show NetworkManager status and permissions. You can also get
 and change system hostname, as well as NetworkManager logging level and domains.
 .TP
-.SS \fICOMMAND\fP := { status | hostname | permissions | logging }
+.B \fICOMMAND\fP := { status | hostname | permissions | logging }
 .sp
 .RS
 .TP
@@ -194,7 +183,7 @@
 networking. Disabling networking removes the configuration from all devices and
 changes them to the 'unmanaged' state.
 .TP
-.SS \fICOMMAND\fP := { [ on | off | connectivity ] }
+.B \fICOMMAND\fP := { [ on | off | connectivity ] }
 .sp
 .RS
 .TP
@@ -232,7 +221,7 @@
 Use this object to show radio switches status, or enable and disable
 the switches.
 .TP
-.SS \fICOMMAND\fP := { all | wifi | wwan | wimax }
+.B \fICOMMAND\fP := { all | wifi | wwan | wimax }
 .sp
 .RS
 .TP
@@ -278,7 +267,7 @@
 connected to the DHCP-enabled network the user would run "nmcli con up default"
 , and when connected to the static network the user would run "nmcli con up testing".
 .TP
-.SS \fICOMMAND\fP := { show | up | down | add | edit | modify | delete | reload | load }
+.B \fICOMMAND\fP := { show | up | down | add | edit | modify | delete | reload | load }
 .sp
 .RS
 .TP
@@ -330,8 +319,7 @@
 .RE
 .TP
 .B up [ id | uuid | path ] <ID> [ifname <ifname>] [ap <BSSID>] [nsp <name>] [passwd <file with passwords>]
-.RE
-.RS
+.TP
 .B up ifname <ifname> [ap <BSSID>] [nsp <name>] [passwd <file with passwords>]
 .RS
 .br
@@ -627,8 +615,7 @@
 .RE
 .TP
 .B edit [id | uuid | path ] <ID>  - edit an existing connection
-.RE
-.RS
+.TP
 .B edit [type <new connection type>] [con-name <new connection name>]  - add a new connection
 .RS
 Edit an existing connection or add a new one, using an interactive editor.
@@ -649,12 +636,12 @@
 \(en type of the new connection; valid types are the same as for \fIconnection add\fP command
 .IP \fIcon-name\fP 13
 \(en name for the new connection. It can be changed later in the editor.
-.RE
 .RS
 .sp
 See also \fInm-settings\fP(5) for all NetworkManager settings and property names, and their
 descriptions; and \fInmcli-examples\fP(5) for sample editor sessions.
 .RE
+.RE
 .TP
 .B modify [--temporary] [ id | uuid | path ] <ID> [+|-]<setting>.<property> <value>
 .B [+|-]<setting>.<property> <value> ...
@@ -711,7 +698,7 @@
 .B device - show and manage network interfaces
 .br
 .TP
-.SS \fICOMMAND\fP := { status | show | connect | disconnect | delete | wifi | wimax }
+.B \fICOMMAND\fP := { status | show | connect | disconnect | delete | wifi | wimax }
 .sp
 .RS
 .TP
@@ -804,7 +791,7 @@
 .B agent \- run nmcli as a NetworkManager secret agent, or polkit agent
 .br
 .TP
-.SS \fICOMMAND\fP := { secret | polkit  | all }
+.B \fICOMMAND\fP := { secret | polkit  | all }
 .sp
 .RS
 .TP