From 3dc3dd161837b314b24e8a9a00718bc1f33aa436 Mon Sep 17 00:00:00 2001 From: Joachim Nilsson Date: Sun, 26 Apr 2015 15:06:15 +0200 Subject: Spell checking and cleanup. - Fix minor spelling errors. - Replace empty lines with .PP (new paragraph) - Replace some underlines with .BR func(section) - Rephrase from spec. language to standard man page anguage. - Reflow too long and too short lines to standard < 72 chars. Signed-off-by: Joachim Nilsson --- doc/bus_open.3 | 38 ++++++++++++++++++++++++-------------- 1 file changed, 24 insertions(+), 14 deletions(-) (limited to 'doc/bus_open.3') diff --git a/doc/bus_open.3 b/doc/bus_open.3 index 72847d7..0bedf00 100644 --- a/doc/bus_open.3 +++ b/doc/bus_open.3 @@ -6,9 +6,16 @@ bus_open - Open a bus int bus_open(bus_t *bus, const char *file, int flags); .SH DESCRIPTION -The \fIbus_open\fP function shall acquire the resources required for the process to use the bus associated with the filename stored in \fIfile\fP. The function shall also store these resource \fIbus\fP for use by other \fBbus\fP functions. - -Values for \fIflags\fP are constructed by a bitwise-inclusive OR of flags from the following list. +The +.BR bus_open(3) +function acquires resources required for the process to use the bus +associated with the filename stored in \fIfile\fP. The function also +stores the resource \fIbus\fP for use by other +.BR bus(5) +functions. +.PP +Values for \fIflags\fP are constructed by a bitwise inclusive OR of +flags from the following list. .TP .IR BUS_RDONLY The process will only be using the bus for receiving messages. @@ -17,9 +24,10 @@ The process will only be using the bus for receiving messages. The process will only be using the bus for sending messages. .TP .IR BUS_RDWR -The process will use the bus for both receiving adn sending messages. +The process will use the bus for both receiving and sending messages. .SH RETURN VALUES -Upon successful completion, the function shall return 0. Otherwise the function shall return -1 and set \fIerrno\fP to indicate the error. +Upon successful completion the function returns 0. Otherwise the +function returns -1 and set \fIerrno\fP to indicate the error. .SH ERRORS .TP .IR ENOMEM @@ -30,16 +38,18 @@ Operation permission is denied to the calling process. .TP .IR EINVAL The described bus does not exist. -.SH -.BR -The \fIbus_open\fP() function may also fail and set \fIerrno\fP to any of the errors specified for the rutine open(2). -.BR +.PP +The +.BR bus_open(3) +function may also fail and set \fIerrno\fP to any of the errors +specified for the routine +.BR open(2). .SH SEE ALSO -bus-create(1), bus(5), libbus(7), bus_open(3), bus_unlink(3) +bus-create(1), bus(5), libbus(7), bus_open(3), bus_unlink(3), open(2) .SH AUTHORS -See the LICENSE file for the authors. +Principal author, Mattias Andrée. See the LICENSE file for the full +list of authors. .SH LICENSE -See the LICENSE file for the terms of redistribution. +MIT/X Consortium License. .SH BUGS -Please report them. - +Please report bugs to https://github.com/maandree/bus/issues -- cgit v1.2.3-70-g09d2