libselinux: man: Fix man pages formatting
- Add man page sections '(N)' to external references, and '()' on
functions described in the same man page.
- Escape minus signs when those are expected to be used on the command
line or files.
- Mark files and variables in italic; Note headings, function names,
constants, program options and man page references in bold.
- Do not justify and hyphenate SEE ALSO section, and avoid hyphenation
on symbol names by prepending them with \%.
- Remove trailing dot from NAME section description.
- Split sections with a no-op command '.', to visually distinguish them
but to avoid introducing spurious vertical space in the formatted
output.
- Add explicit .sp commands in the SYNOPSIS section between function
prototypes, and fix space placement in function protoypes.
- Split header includes with .br (instead of the explicit or implicit
.sp) so that they are vertically contiguous.
- Add missing {} around SELINUXTYPE and POLICYTYPE variable text in
paths.
- Remove unneeded formatting commands.
- Remove spurious blank lines.
Signed-off-by: Guillem Jover <[email protected]>
Signed-off-by: Eric Paris <[email protected]>
Acked-by: Dan Walsh <[email protected]>
diff --git a/libselinux/man/man5/service_seusers.5 b/libselinux/man/man5/service_seusers.5
index 59a135a..385a326 100644
--- a/libselinux/man/man5/service_seusers.5
+++ b/libselinux/man/man5/service_seusers.5
@@ -1,8 +1,7 @@
.TH "service_seusers" "5" "28-Nov-2011" "Security Enhanced Linux" "SELinux configuration"
-
.SH "NAME"
-service_seusers \- The SELinux GNU/Linux user and service to SELinux user mapping configuration files.
-
+service_seusers \- The SELinux GNU/Linux user and service to SELinux user mapping configuration files
+.
.SH "DESCRIPTION"
These are optional files that allow services to define an SELinux user when authenticating via SELinux-aware login applications such as
.BR PAM "(8). "
@@ -20,7 +19,7 @@
Where \fI{SELINUXTYPE}\fR is the entry from the selinux configuration file \fIconfig\fR (see \fBselinux_config\fR(5)).
.sp
.BR getseuser "(3) reads this file to map services to an SELinux user. "
-
+.
.SH "FILE FORMAT"
Each line within the \fIusername\fR file is formatted as follows with each component separated by a colon:
.RS
@@ -42,9 +41,9 @@
The range for MCS/MLS policies.
.RE
.RE
-
+.
.SH "EXAMPLES"
-Example 1 \- for the 'root' user:
+Example 1 - for the 'root' user:
.RS
# ./logins/root
.br
@@ -53,7 +52,7 @@
this_service:unconfined_u:s0
.RE
.sp
-Example 2 \- for GNU/Linux user 'rch':
+Example 2 - for GNU/Linux user 'rch':
.RS
# ./logins/rch
.br
@@ -61,6 +60,8 @@
.br
that_service:unconfined_u:s0
.RE
-
+.
.SH "SEE ALSO"
+.ad l
+.nh
.BR selinux "(8), " PAM "(8), " selinux_policy_root "(3), " getseuser "(3), " selinux_config "(5) "
