specifications for timed functions + fix manpage formatting

Signed-off-by: Mattias Andrée <maandree@operamail.com>

1 files changed, 21 insertions, 13 deletions

diff --git a/doc/bus_chown.3 b/doc/bus_chown.3
index 86e9481..186e937 100644
--- a/doc/bus_chown.3
+++ b/doc/bus_chown.3
@@ -2,32 +2,40 @@
 .SH NAME
 bus_chown - Change bus owner and group
 .SH SYNOPSIS
+.LP
+.nf
 #include <bus.h>
-
-int bus_chown(const char *file, uid_t owner, gid_t group);
+.P
+int bus_chown(const char *\fIfile\fP, uid_t \fIowner\fP, gid_t \fIgroup\fP);
+.fi
 .SH DESCRIPTION
-The \fIbus_chown()\fP function change the owner and the group of the bus
-associated with \fIfile\fP to the \fIowner\fP and \fIgroup\fP,
-respectively.
+The
+.BR bus_chown ()
+function change the owner and the group of the bus associated with
+\fIfile\fP to the \fIowner\fP and \fIgroup\fP, respectively.
 .SH RETURN VALUES
 Upon successful completion, the function returns 0.  Otherwise the
 function returns -1 and sets \fIerrno\fP to indicate the error.
 .SH ERRORS
 The
-.BR bus_chown(3)
+.BR bus_chown (3)
 function may fail and set \fIerrno\fP to any of the
 errors specified for
-.BR bus_open(3),
-.BR chown(3),
-.BR semget(3),
-.BR shmget(3)
+.BR bus_open (3),
+.BR chown (3),
+.BR semget (3),
+.BR shmget (3)
 and
-.BR shmctl(3)
+.BR shmctl (3)
 as well as any errors specified for the \fIIPC_STAT\fP and
 \fIIPC_SET\fP commands for
-.BR semctl(3).
+.BR semctl (3).
 .SH SEE ALSO
-bus-create(1), bus(5), libbus(7), bus_open(3), bus_read(3)
+.BR bus-create (1),
+.BR bus (5),
+.BR libbus (7),
+.BR bus_open (3),
+.BR bus_read (3)
 .SH AUTHORS
 Principal author, Mattias Andrée.  See the LICENSE file for the full
 list of authors.