11622 clean up rarer mandoc lint warnings

Reviewed by: Yuri Pankov <yuri.pankov@nexenta.com>
Reviewed by: Toomas Soome <tsoome@me.com>
Approved by: Robert Mustacchi <rm@joyent.com>

6 files changed, 4 insertions, 75 deletions

diff --git a/usr/src/man/man3c/epoll_create.3c b/usr/src/man/man3c/epoll_create.3c
index 83ea81e204..624e0f3a16 100644
--- a/usr/src/man/man3c/epoll_create.3c
+++ b/usr/src/man/man3c/epoll_create.3c
@@ -4,7 +4,7 @@
 .\"  Common Development and Distribution License ("CDDL"), version 1.0.
 .\"  You may only use this file in accordance with the terms of version
 .\"  1.0 of the CDDL.
-.\" 
+.\"
 .\"  A full copy of the text of the CDDL should have accompanied this
 .\"  source.  A copy of the CDDL is also available via the Internet at
 .\"  http://www.illumos.org/license/CDDL.
@@ -12,8 +12,6 @@
 .SH NAME
 epoll_create, epoll_create1 \- create an epoll instance
 .SH SYNOPSIS
-
-.LP
 .nf
 #include <sys/epoll.h>
 
@@ -26,7 +24,6 @@ epoll_create, epoll_create1 \- create an epoll instance
 .fi
 
 .SH DESCRIPTION
-.LP
 The \fBepoll_create()\fR and \fBepoll_create1()\fR functions both create an
 \fBepoll\fR(5) instance that can be operated upon via \fBepoll_ctl\fR(3C),
 \fBepoll_wait\fR(3C) and \fBepoll_pwait\fR(3C).  \fBepoll\fR instances are
@@ -49,11 +46,9 @@ Instance should be closed upon an
 .RE
 
 .SH RETURN VALUES
-.LP
 Upon successful completion, 0 is returned. Otherwise, -1 is returned and errno
 is set to indicate the error.
 .SH ERRORS
-.LP
 The \fBepoll_create()\fR and \fBepoll_create1()\fR functions will fail if:
 .sp
 .ne 2
@@ -86,8 +81,6 @@ The maximum allowable number of files is currently open in the system.
 
 .sp
 .SH NOTES
-.LP
-
 The \fBepoll\fR(5) facility is implemented for purposes of offering
 compatibility for Linux-borne applications; native
 applications should continue to prefer using event ports via the
@@ -95,5 +88,4 @@ applications should continue to prefer using event ports via the
 interfaces.  See \fBepoll\fR(5) for compatibility details and restrictions.
 
 .SH SEE ALSO
-.LP
 \fBepoll_ctl\fR(3C), \fBepoll_wait\fR(3C), \fBepoll\fR(5)
diff --git a/usr/src/man/man3c/epoll_ctl.3c b/usr/src/man/man3c/epoll_ctl.3c
index 4d63d084f9..3b3dfabcba 100644
--- a/usr/src/man/man3c/epoll_ctl.3c
+++ b/usr/src/man/man3c/epoll_ctl.3c
@@ -12,8 +12,6 @@
 .SH NAME
 epoll_ctl \- control an epoll instance
 .SH SYNOPSIS
-
-.LP
 .nf
 #include <sys/epoll.h>
 
@@ -21,7 +19,6 @@ epoll_ctl \- control an epoll instance
 .fi
 
 .SH DESCRIPTION
-.LP
 The \fBepoll_ctl()\fR function executes the operation specified by
 \fIop\fR (as parameterized by \fIevent\fR) on the \fIepfd\fR epoll instance.
 Valid values for \fIop\fR:
@@ -244,13 +241,11 @@ with caution.
 .RE
 
 .SH RETURN VALUES
-.LP
 Upon successful completion, \fBepoll_ctl()\fR returns 0.
 If an error occurs, -1 is returned and errno is set to indicate
 the error.
 
 .SH ERRORS
-.LP
 \fBepoll_ctl()\fR will fail if:
 .sp
 .ne 2
@@ -294,8 +289,6 @@ specified \fBepoll\fR(5) instance.
 
 .sp
 .SH NOTES
-.LP
-
 The \fBepoll\fR(5) facility is implemented for purposes of offering
 compatibility for Linux-borne applications; native
 applications should continue to prefer using event ports via the
@@ -303,7 +296,6 @@ applications should continue to prefer using event ports via the
 interfaces.  See \fBepoll\fR(5) for compatibility details and restrictions.
 
 .SH SEE ALSO
-.LP
 \fBepoll_create\fR(3C), \fBepoll_wait\fR(3C),
 \fBport_create\fR(3C), \fBport_associate\fR(3C), \fBport_get\fR(3C),
 \fBepoll\fR(5)
diff --git a/usr/src/man/man3c/epoll_wait.3c b/usr/src/man/man3c/epoll_wait.3c
index 6ae9e0f9c4..7808661238 100644
--- a/usr/src/man/man3c/epoll_wait.3c
+++ b/usr/src/man/man3c/epoll_wait.3c
@@ -4,7 +4,7 @@
 .\"  Common Development and Distribution License ("CDDL"), version 1.0.
 .\"  You may only use this file in accordance with the terms of version
 .\"  1.0 of the CDDL.
-.\" 
+.\"
 .\"  A full copy of the text of the CDDL should have accompanied this
 .\"  source.  A copy of the CDDL is also available via the Internet at
 .\"  http://www.illumos.org/license/CDDL.
@@ -12,24 +12,21 @@
 .SH NAME
 epoll_wait, epoll_pwait \- wait for epoll events
 .SH SYNOPSIS
-
-.LP
 .nf
 #include <sys/epoll.h>
 
-\fBint\fR \fBepoll_wait\fR(\fBint\fR \fIepfd\fR, \fBstruct epoll_event *\fR\fIevents\fR, 
+\fBint\fR \fBepoll_wait\fR(\fBint\fR \fIepfd\fR, \fBstruct epoll_event *\fR\fIevents\fR,
      \fBint\fR \fImaxevents\fR, \fBint\fR \fItimeout\fR);
 .fi
 
 .LP
 .nf
-\fBint\fR \fBepoll_pwait\fR(\fBint\fR \fIepfd\fR, \fBstruct epoll_event *\fR\fIevents\fR, 
+\fBint\fR \fBepoll_pwait\fR(\fBint\fR \fIepfd\fR, \fBstruct epoll_event *\fR\fIevents\fR,
      \fBint\fR \fImaxevents\fR, \fBint\fR \fItimeout\fR,
      \fBconst sigset_t *\fR\fIsigmask\fR);
 .fi
 
 .SH DESCRIPTION
-.LP
 The \fBepoll_wait()\fR function waits for events on the \fBepoll\fR(5)
 instance specified by \fIepfd\fR.  The \fIevents\fR parameter must point to
 an array of \fImaxevents\fR \fIepoll_event\fR structures to be
@@ -45,14 +42,12 @@ signal mask upon return, and is therefore similar to the relationship
 between \fBselect\fR(3C) and \fBpselect\fR(3C).
 
 .SH RETURN VALUES
-.LP
 Upon successful completion, \fBepoll_wait()\fR and \fBepoll_pwait()\fR return
 the number of events, or 0 if none was pending and \fItimeout\fR milliseconds
 elapsed.  If an error occurs, -1 is returned and errno is set to indicate
 the error.
 
 .SH ERRORS
-.LP
 The \fBepoll_wait()\fR and \fBepoll_pwait()\fR functions will fail if:
 .sp
 .ne 2
@@ -93,8 +88,6 @@ is not greater than zero.
 
 .sp
 .SH NOTES
-.LP
-
 The \fBepoll\fR(5) facility is implemented for purposes of offering
 compatibility for Linux-borne applications; native
 applications should continue to prefer using event ports via the
@@ -102,7 +95,6 @@ applications should continue to prefer using event ports via the
 interfaces.  See \fBepoll\fR(5) for compatibility details and restrictions.
 
 .SH SEE ALSO
-.LP
 \fBepoll_create\fR(3C), \fBepoll_ctl\fR(3C),
 \fBport_create\fR(3C), \fBport_associate\fR(3C), \fBport_get\fR(3C),
 \fBpselect\fR(3C), \fBepoll\fR(5)
diff --git a/usr/src/man/man3c/getlogin.3c b/usr/src/man/man3c/getlogin.3c
index 7b1cdd165f..41211c78c7 100644
--- a/usr/src/man/man3c/getlogin.3c
+++ b/usr/src/man/man3c/getlogin.3c
@@ -49,7 +49,6 @@
 .SH NAME
 getlogin, getlogin_r \- get login name
 .SH SYNOPSIS
-.LP
 .nf
 #include <unistd.h>
 
@@ -62,7 +61,6 @@ getlogin, getlogin_r \- get login name
 .fi
 
 .SS "Standard conforming"
-.LP
 .nf
 cc [ \fIflag \fR... ] \fIfile\fR... \fB-D_POSIX_PTHREAD_SEMANTICS\fR [ \fIlibrary \fR... ]
 
@@ -70,8 +68,6 @@ cc [ \fIflag \fR... ] \fIfile\fR... \fB-D_POSIX_PTHREAD_SEMANTICS\fR [ \fIlibrar
 .fi
 
 .SH DESCRIPTION
-.sp
-.LP
 The \fBgetlogin()\fR function returns a pointer to the login name as found in
 \fB/var/adm/utmpx\fR. It can be used in conjunction with \fBgetpwnam\fR(3C) to
 locate the correct password file entry when the same user \fBID\fR is shared by
@@ -106,7 +102,6 @@ login name is to call \fBcuserid\fR(3C), or to call \fBgetlogin()\fR and if it
 fails to call \fBgetpwuid\fR(3C).
 .sp
 .LP
-
 The \fBgetlogin_r()\fR function has the same functionality as \fBgetlogin()\fR
 except that the caller must supply a buffer \fIname\fR with length \fInamelen\fR
 to store the result.  The \fIname\fR buffer should be at least
@@ -118,8 +113,6 @@ terminator, does not fit inside the buffer, than an error will be generated.
 Otherwise, the buffer \fIname\fR will be updated with the login name.
 
 .SH RETURN VALUES
-.sp
-.LP
 Upon successful completion, \fBgetlogin()\fR returns a pointer to the login
 name or a null pointer if the user's login name cannot be found.  Otherwise it
 returns a null pointer and sets \fBerrno\fR to indicate the error.
@@ -128,8 +121,6 @@ returns a null pointer and sets \fBerrno\fR to indicate the error.
 The standard-conforming \fBgetlogin_r()\fR returns \fB0\fR if successful, or
 the error number upon failure.
 .SH ERRORS
-.sp
-.LP
 The \fBgetlogin_r()\fR function will fail if:
 .sp
 .ne 2
@@ -193,8 +184,6 @@ The size of the buffer is smaller than the result to be returned.
 .RE
 
 .SH USAGE
-.sp
-.LP
 The return value of \fBgetlogin()\fR points to thread-specific data whose
 content is overwritten on each call by the same thread.
 .sp
@@ -205,7 +194,6 @@ effective user ID of the process; \fBgetlogin()\fR returns the name associated
 with the current login activity; and \fBgetpwuid(\fR\fBgetuid()\fR\fB)\fR
 returns the name associated with the real user ID of the process.
 .SH FILES
-.sp
 .ne 2
 .na
 \fB\fB/var/adm/utmpx\fR\fR
@@ -233,8 +221,6 @@ A 64-bit compatibility library to return long login names.
 .RE
 
 .SH ATTRIBUTES
-.sp
-.LP
 See \fBattributes\fR(5) for descriptions of the following attributes:
 .sp
 
@@ -251,14 +237,10 @@ MT-Level	See below.
 .TE
 
 .SH SEE ALSO
-.sp
-.LP
 \fBgeteuid\fR(2), \fBgetuid\fR(2), \fBcuserid\fR(3C), \fBgetgrnam\fR(3C),
 \fBgetpwnam\fR(3C), \fBgetpwuid\fR(3C), \fButmpx\fR(4), \fBattributes\fR(5),
 \fBstandards\fR(5)
 .SH NOTES
-.sp
-.LP
 When compiling multithreaded programs, see \fBIntro\fR(3).
 .sp
 .LP
diff --git a/usr/src/man/man3c/nanosleep.3c b/usr/src/man/man3c/nanosleep.3c
index e29808e560..ba1e275bb0 100644
--- a/usr/src/man/man3c/nanosleep.3c
+++ b/usr/src/man/man3c/nanosleep.3c
@@ -49,7 +49,6 @@
 .SH NAME
 nanosleep, thrd_sleep \- high resolution sleep
 .SH SYNOPSIS
-.LP
 .nf
 #include <time.h>
 
@@ -64,7 +63,6 @@ nanosleep, thrd_sleep \- high resolution sleep
      \fBstruct timespec *\fR\fIrmtp\fR);
 
 .SH DESCRIPTION
-.LP
 The \fBnanosleep()\fR and \fBthrd_sleep()\fR functions cause the current thread
 to be suspended from execution until either the time interval specified by the
 \fIrqtp\fR argument has elapsed or a signal is delivered to the calling thread
@@ -80,7 +78,6 @@ time specified by \fIrqtp\fR, as measured by the system clock,
 The use of the \fBnanosleep()\fR and \fBthrd_sleep()\fR functions has no effect
 on the action or blockage of any signal.
 .SH RETURN VALUES
-.LP
 If the \fBnanosleep()\fR or \fBthrd_sleep()\fR function returns because the
 requested time has elapsed, its return value is \fB0\fR.
 .sp
@@ -98,7 +95,6 @@ If \fBnanosleep()\fR fails, it returns \fB\(mi1\fR and sets \fBerrno\fR to
 indicate the error.
 .sp
 .LP
-
 The
 .B thrd_sleep()
 function may fail for identical reasons as the
@@ -111,7 +107,6 @@ being set or staying the same across a call to
 .B thrd_sleep() .
 
 .SH ERRORS
-.LP
 The \fBnanosleep()\fR function will fail if:
 .sp
 .ne 2
@@ -142,7 +137,6 @@ The \fBnanosleep()\fR function is not supported by this implementation.
 .RE
 
 .SH ATTRIBUTES
-.LP
 See \fBattributes\fR(5) for descriptions of the following attributes:
 .sp
 
@@ -161,5 +155,4 @@ Standard	See \fBstandards\fR(5).
 .TE
 
 .SH SEE ALSO
-.LP
 \fBsleep\fR(3C), \fBtime.h\fR(3HEAD), \fBattributes\fR(5), \fBstandards\fR(5)
diff --git a/usr/src/man/man3c/pfmt.3c b/usr/src/man/man3c/pfmt.3c
index b88e451266..907e32c981 100644
--- a/usr/src/man/man3c/pfmt.3c
+++ b/usr/src/man/man3c/pfmt.3c
@@ -7,7 +7,6 @@
 .SH NAME
 pfmt \- display error message in standard format
 .SH SYNOPSIS
-.LP
 .nf
 #include <pfmt.h>
 
@@ -15,8 +14,6 @@ pfmt \- display error message in standard format
 .fi
 
 .SH DESCRIPTION
-.sp
-.LP
 The \fBpfmt()\fR retrieves a format string from a locale-specific message
 database (unless \fBMM_NOGET\fR is specified) and uses it for \fBprintf\fR(3C)
 style formatting of \fIargs\fR. The output is displayed on \fIstream\fR.
@@ -191,8 +188,6 @@ localized version of \fBTO FIX\fR.
 .RE
 
 .SH STANDARD ERROR MESSAGE FORMAT
-.sp
-.LP
 The \fBpfmt()\fR function displays error messages in the following format:
 .sp
 .in +2
@@ -223,17 +218,7 @@ If \fBpfmt()\fR is called twice to display an error message and a helpful
 .fi
 .in -2
 
-.br
-.in +2
-
-.in -2
-.br
-.in +2
-
-.in -2
 .SH RETURN VALUES
-.sp
-.LP
 Upon success, \fBpfmt()\fR returns the number of bytes transmitted. Upon
 failure, it returns a negative value:
 .sp
@@ -246,7 +231,6 @@ Write error to \fIstream\fR.
 .RE
 
 .SH EXAMPLES
-.LP
 \fBExample 1 \fRExample of \fBpfmt()\fR function.
 .sp
 .LP
@@ -292,12 +276,8 @@ UX:test: TO FIX: Usage ...
 .in -2
 
 .SH USAGE
-.sp
-.LP
 Since it uses \fBgettxt\fR(3C), \fBpfmt()\fR should not be used.
 .SH ATTRIBUTES
-.sp
-.LP
 See \fBattributes\fR(5) for descriptions of the following attributes:
 .sp
 
@@ -312,8 +292,6 @@ MT-Level	MT-safe
 .TE
 
 .SH SEE ALSO
-.sp
-.LP
 \fBaddsev\fR(3C), \fBgettxt\fR(3C), \fBlfmt\fR(3C), \fBprintf\fR(3C),
 \fBsetcat\fR(3C), \fBsetlabel\fR(3C), \fBsetlocale\fR(3C), \fBattributes\fR(5),
 \fBenviron\fR(5)