nsenter: improve optional args in usage() and man page

Signed-off-by: Karel Zak <kzak@redhat.com>

1 files changed, 11 insertions, 9 deletions

diff --git a/sys-utils/nsenter.1 b/sys-utils/nsenter.1
index 93c512edc..0fbb645a3 100644
--- a/sys-utils/nsenter.1
+++ b/sys-utils/nsenter.1
@@ -37,6 +37,9 @@ process will have distinct set of uids, gids and capabilities. (\fBCLONE_NEWUSER
 .TP
 See the \fBclone\fR(2) for exact semantics of the flags.
 .SH OPTIONS
+Note when specifying the optional \fB<file>\fP or \fB<directory>\fP arguments, the string
+of the option, equal sign (=), and the optional argument must not contain any blanks
+or other white space.
 .TP
 .BR \-h , " \-\-help"
 Print a help message,
@@ -44,42 +47,42 @@ Print a help message,
 .BR \-t , " \-\-target " \fIpid\fP
 Specify a target process to get contexts from.  The paths to the contexts specified by pid are: /proc/[pid]/ns/mnt, /proc/[pid]/ns/uts, /proc/[pid]/ns/ipc, /proc/[pid]/ns/net, /proc/[pid]/ns/pid, /proc/[pid]/ns/user, /proc/[pid]/root, /proc/[pid]/cwd for the mount namespace, the uts namespace, the ipc namespace, the net namespace, the pid namespace, the user namespace, the root directory and the working directory respectively.
 .TP
-.BR \-m , " \-\-mount"=[\fIfile\fP]
+.BR \-m , " \-\-mount"[=\fIfile\fP]
 Enter the mount namespace.
 If no file is specified enter the mount namespace of the target process.
 If file is specified enter the mount namespace specified by file.
 .TP
-.BR \-u , " \-\-uts"=[\fIfile\fP]
+.BR \-u , " \-\-uts"[=\fIfile\fP]
 Enter the uts namespace.
 If no file is specified enter the uts namespace of the target process.
 If file is specified enter the uts namespace specified by file.
 .TP
-.BR \-i , " \-\-ipc "=[\fIfile\fP]
+.BR \-i , " \-\-ipc"[=\fIfile\fP]
 Enter the IPC namespace.
 If no file is specified enter the IPC namespace of the target process.
 If file is specified enter the uts namespace specified by file.
 .TP
-.BR \-n , " \-\-net"=[\fIfile\fP]
+.BR \-n , " \-\-net"[=\fIfile\fP]
 Enter the network namespace.
 If no file is specified enter the network namespace of the target process.
 If file is specified enter the network namespace specified by file.
 .TP
-.BR \-p , " \-\-pid"=[\fIfile\fP]
+.BR \-p , " \-\-pid"[=\fIfile\fP]
 Enter the pid namespace.
 If no file is specified enter the pid namespace of the target process.
 If file is specified enter the pid namespace specified by file.
 .TP
-.BR \-U , " \-\-user"=[\fIfile\fP]
+.BR \-U , " \-\-user"[=\fIfile\fP]
 Enter the user namespace.
 If no file is specified enter the user namespace of the target process.
 If file is specified enter the user namespace specified by file.
 .TP
-.BR \-r , " \-\-root"=[\fIdirectory\fP]
+.BR \-r , " \-\-root"[=\fIdirectory\fP]
 Set the root directory.
 If no directory is specified set the root directory to the root directory of the target process.
 If directory is specified set the root directory to the specified directory.
 .TP
-.BR \-w , " \-\-wd"=[\fIdirectory\fP]
+.BR \-w , " \-\-wd"[=\fIdirectory\fP]
 Set the working directory.
 If no directory is specified set the working directory to the working directory of the target process.
 If directory is specified set the working directory to the specified directory.
@@ -88,7 +91,6 @@ If directory is specified set the working directory to the specified directory.
 Don't fork before exec'ing the specified program.  By default when entering
 a pid namespace enter calls fork before calling exec so that the children will
 be in the newly entered pid namespace.
-.SH NOTES
 .SH SEE ALSO
 .BR setns (2),
 .BR clone (2)