aboutsummaryrefslogtreecommitdiffstats
path: root/doc/bus_open.3
diff options
context:
space:
mode:
authorMattias Andrée [mˈa.tːiː.ˌas ˈanː.drˌeː] <maandree@member.fsf.org>2015-04-26 20:37:36 +0000
committerMattias Andrée [mˈa.tːiː.ˌas ˈanː.drˌeː] <maandree@member.fsf.org>2015-04-26 20:37:36 +0000
commitcbf470c2427c7fee248afa701c84c500c799f0ad (patch)
tree3bfc53624f6dc78343ed27c64a1d25a258898c1e /doc/bus_open.3
parentfix doc (diff)
parentSpell checking and cleanup. (diff)
downloadbus-cbf470c2427c7fee248afa701c84c500c799f0ad.tar.gz
bus-cbf470c2427c7fee248afa701c84c500c799f0ad.tar.bz2
bus-cbf470c2427c7fee248afa701c84c500c799f0ad.tar.xz
Merge pull request #3 from troglobit/master
Spell checking and cleanup.
Diffstat (limited to 'doc/bus_open.3')
-rw-r--r--doc/bus_open.338
1 files changed, 24 insertions, 14 deletions
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