[PATCH 01/15] Manual pages: various pages: Use "\-" for real minus signs
Michael Kerrisk (man-pages)
mtk.manpages at gmail.com
Mon Jul 20 09:13:14 UTC 2020
Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages at gmail.com>
---
doc/cap_get_proc.3 | 8 ++++----
doc/capsh.1 | 14 +++++++-------
doc/getpcaps.8 | 6 +++---
doc/libpsx.3 | 6 +++---
4 files changed, 17 insertions(+), 17 deletions(-)
diff --git a/doc/cap_get_proc.3 b/doc/cap_get_proc.3
index fda00e0..fce8f59 100644
--- a/doc/cap_get_proc.3
+++ b/doc/cap_get_proc.3
@@ -242,11 +242,11 @@ is packaged with a separate POSIX semantics system call library:
If your program uses POSIX threads, to achieve meaningful POSIX
semantics capability manipulation, you should link your program with:
.sp
-.B ld ... -lcap -lpsx -lpthread --wrap=pthread_create
+.B ld ... \-lcap \-lpsx \-lpthread \-\-wrap=pthread_create
.sp
or,
.sp
-.B gcc ... -lcap -lpsx -lpthread -Wl,-wrap,pthread_create
+.B gcc ... \-lcap \-lpsx \-lpthread \-Wl,\-wrap,pthread_create
.sp
When linked this way, due to linker magic, libcap uses
.BR psx_syscall "(3) and " psx_syscall6 (3)
@@ -362,10 +362,10 @@ Note, the above sequence can be performed by the
.B capsh
tool as follows:
.sp
-.B sudo /sbin/capsh --user=nobody --mode=NOPRIV --print
+.B sudo /sbin/capsh \-\-user=nobody \-\-mode=NOPRIV \-\-print
.sp
where
-.B --print
+.B \-\-print
displays the resulting privilege state.
.SH "SEE ALSO"
.BR libcap (3),
diff --git a/doc/capsh.1 b/doc/capsh.1
index 0b987f0..242727c 100644
--- a/doc/capsh.1
+++ b/doc/capsh.1
@@ -107,7 +107,7 @@ preparations for setting the uid without dropping capabilities in the
process. Following this command the prevailing effective capabilities
will be lowered.
.TP
-.BI \-\-is-uid= <id>
+.BI \-\-is\-uid= <id>
Exit with status 1 unless the current
.IR uid " equals " <id> .
.TP
@@ -120,7 +120,7 @@ using the
.BR setgid (2)
system call.
.TP
-.BI \-\-is-gid= <id>
+.BI \-\-is\-gid= <id>
Exit with status 1 unless the current
.IR gid " equals " <id> .
.TP
@@ -129,7 +129,7 @@ Set the supplementary groups to the numerical list provided. The
groups are set with the
.BR setgroups (2)
system call. See
-.B --user
+.B \-\-user
for a more convenient way of doing this.
.TP
.BI \-\-keep= <0|1>
@@ -152,7 +152,7 @@ the current process. In all cases,
is deactivated when an
.BR exec ()
is performed. See
-.B --secbits
+.B \-\-secbits
for ways to disable this feature.
.TP
.BI \-\-secbits= N
@@ -225,18 +225,18 @@ will cause capsh to promptly exit with a status of 1 when run on
kernel 2.6.27. However, when run on kernel 2.6.38 it will silently
succeed.
.TP
-.BI \-\-has-p= xxx
+.BI \-\-has\-p= xxx
Exit with status 1 unless the
.I permitted
vector has capability
.B xxx
raised.
.TP
-.B \-\-has-ambient
+.B \-\-has\-ambient
Performs a check to see if the running kernel supports ambient
capabilities. If not, the capsh command exits with status 1.
.TP
-.BI \-\-has-a= xxx
+.BI \-\-has\-a= xxx
Exit with status 1 unless the
.I ambient
vector has capability
diff --git a/doc/getpcaps.8 b/doc/getpcaps.8
index 53d342e..7b73e86 100644
--- a/doc/getpcaps.8
+++ b/doc/getpcaps.8
@@ -24,13 +24,13 @@ format.
.PP
Optional arguments:
.PP
-.BR --help " or " --usage
+.BR \-\-help " or " \-\-usage
Displays usage information and exits.
.PP
-.BR --ugly " or " --legacy
+.BR \-\-ugly " or " \-\-legacy
Displays output in a somewhat ugly legacy format.
.PP
-.B --verbose
+.B \-\-verbose
Displays usage in a legacy-like format but not quite so ugly in modern
default terminal fonts.
.SH SEE ALSO
diff --git a/doc/libpsx.3 b/doc/libpsx.3
index 615fceb..a907d8b 100644
--- a/doc/libpsx.3
+++ b/doc/libpsx.3
@@ -11,9 +11,9 @@ psx_syscall3, psx_syscall6 \- POSIX semantics for system calls
.sp
Link with one of these:
.sp
-.I ld ... -lpsx -lpthread --wrap=pthread_create
+.I ld ... \-lpsx \-lpthread \-\-wrap=pthread_create
.sp
-.I gcc ... -lpsx -lpthread -Wl,-wrap,pthread_create
+.I gcc ... \-lpsx \-lpthread \-Wl,\-wrap,pthread_create
.SH DESCRIPTION
The
.B libpsx
@@ -58,7 +58,7 @@ and
functions.
.SH RETURN VALUE
The return value for system call functions is generally the value
-returned by the kernel, or -1 in the case of an error. In such cases
+returned by the kernel, or \-1 in the case of an error. In such cases
.BR errno (3)
is set to the detailed error value. The
.BR psx_syscall3 " and " psx_syscall6
--
2.26.2
More information about the Linux-security-module-archive
mailing list