[src/trunk]: src/lib/libc/sys Trivia: one .Pp after .El, speak about NULL ins...

[jruoho <jruoho%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/ae980829ef57
branches:  trunk
changeset: 753604:ae980829ef57
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Sat Apr 03 14:40:34 2010 +0000

description:
Trivia: one .Pp after .El, speak about NULL instead of nil pointers, etc.

diffstat:

 lib/libc/sys/acct.2 |  29 +++++++++++++++--------------
 1 files changed, 15 insertions(+), 14 deletions(-)

diffs (61 lines):

diff -r 614784b7223d -r ae980829ef57 lib/libc/sys/acct.2
--- a/lib/libc/sys/acct.2       Sat Apr 03 14:19:17 2010 +0000
+++ b/lib/libc/sys/acct.2       Sat Apr 03 14:40:34 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: acct.2,v 1.16 2004/05/13 10:20:57 wiz Exp $
+.\"    $NetBSD: acct.2,v 1.17 2010/04/03 14:40:34 jruoho Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -44,21 +44,19 @@
 .Sh DESCRIPTION
 The
 .Fn acct
-call enables or disables the collection of system accounting
-records.
-If the argument
-.Fa file
-is a nil pointer, accounting is disabled.
+call enables or disables the collection of system accounting records.
 If
 .Fa file
-is an
-.Em existing
-pathname (null-terminated), record collection is enabled and for
-every process initiated which terminates under normal
+is
+.Dv NULL ,
+accounting is disabled.
+If
+.Fa file
+is an existing, NUL-terminated, pathname, record collection is enabled,
+and for every process initiated which terminates under normal
 conditions an accounting record is appended to
 .Fa file .
-Abnormal conditions of termination are reboots
-or other fatal system problems.
+Abnormal conditions of termination are reboots or other fatal system problems.
 Records for processes which never terminate can not be
 produced by
 .Fn acct .
@@ -80,8 +78,10 @@
 creates a kernel thread called
 .Dq acctwatch .
 .Sh RETURN VALUES
-On error \-1 is returned.
-The file must exist and the call may be exercised only by the super-user.
+On success, zero is returned.
+Otherwise, \-1 is returned and
+.Va errno
+is set to indicate the error.
 .Sh ERRORS
 .Fn acct
 will fail if one of the following is true:
@@ -111,6 +111,7 @@
 .It Bq Er EIO
 An I/O error occurred while reading from or writing to the file system.
 .El
+.Pp
 Also,
 .Fn acct
 fails if failed to create kernel thread described above.