Index: doc/man3/roar_connect.3
===================================================================
--- doc/man3/roar_connect.3	(revision 159)
+++ doc/man3/roar_connect.3	(revision 159)
@@ -0,0 +1,42 @@
+.\" roar_simple_play.3:
+
+.TH "roar_connect" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_connect \- connects to RoarAudio's sound server
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_connect(struct roar_connection * con, char * server);
+
+.SH "DESCRIPTION"
+Connects to RoarAudio's sound server.
+This call just connects to the sound server without any auth or identify.
+Do not use this from end user applications. Use \fBroar_simple_connect\fR(3).
+
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+The connection object to be filled with the data needed to talk to the server used by nearly all other calls.
+
+.TP
+\fBserver\fR
+The server to connect to.
+This may be in form "host[:port]" (TCP/IP) or "/path/to/sock" (UNIX Domain Socket).
+
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+See libroar/simple.c, \fBroar_simple_connect\fR(3).
+
+.SH "SEE ALSO"
+\fBroar_simple_connect\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_disconnect.3
===================================================================
--- doc/man3/roar_disconnect.3	(revision 159)
+++ doc/man3/roar_disconnect.3	(revision 159)
@@ -0,0 +1,34 @@
+.\" roar_simple_play.3:
+
+.TH "roar_disconnect" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_disconnect \- disconnect from RoarAudio's sound server
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_disconnect(struct roar_connection * con);
+
+.SH "DESCRIPTION"
+Closes es connection previously opend via \fBBroar_simple_connect\fR(3).
+
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+The connection to be closed.
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBroar_simple_connect\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_exit.3
===================================================================
--- doc/man3/roar_exit.3	(revision 159)
+++ doc/man3/roar_exit.3	(revision 159)
@@ -0,0 +1,37 @@
+.\" roar_simple_play.3:
+
+.TH "roar_exit" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_exit \- let RoarAudio's sound server quit
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_exit(struct roar_connection * con);
+
+.SH "DESCRIPTION"
+Ask the sound server to quit.
+
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+An open controll connection to the server.
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "NOTES"
+Even when the call was successfull you have to use \fBroar_disconnect\fR(3) to disconnect from the server.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBroar_disconnect\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_get_standby.3
===================================================================
--- doc/man3/roar_get_standby.3	(revision 159)
+++ doc/man3/roar_get_standby.3	(revision 159)
@@ -0,0 +1,40 @@
+.\" roar_simple_play.3:
+
+.TH "roar_get_standby" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_get_standby, roar_set_standby \- Get and set RoarAudio's sound servers standby state
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_get_standby(struct roar_connection * con);
+
+int roar_set_standby(struct roar_connection * con, int state);
+
+.SH "DESCRIPTION"
+Get or set the standby state of the server. If the server is in standby no audio is played. The audio device may be released depending on configuration.
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+The connection to the server.
+
+.TP
+\fBstate\fR
+The new state. This may be \fBROAR_STANDBY_ACTIVE\fR for standby to be set active or \fBROAR_STANDBY_INACTIVE\fR for normal operating mode.
+
+.SH "RETURN VALUE"
+\fBroar_get_standby\fR returns \fBROAR_STANDBY_ACTIVE\fR, \fBROAR_STANDBY_INACTIVE\fR or -1 on error.
+\fBroar_set_standby\fR returns on success 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBroar_simple_get_standby\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_get_vol.3
===================================================================
--- doc/man3/roar_get_vol.3	(revision 159)
+++ doc/man3/roar_get_vol.3	(revision 159)
@@ -0,0 +1,50 @@
+.\" roar_simple_play.3:
+
+.TH "roar_get_vol" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_get_vol, roar_set_vol \- Set mixer levels or RoarAudio streams
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_set_vol(struct roar_connection * con, int id, struct roar_mixer_settings * mixer, int   channels);
+
+int roar_get_vol(struct roar_connection * con, int id, struct roar_mixer_settings * mixer, int * channels);
+
+.SH "DESCRIPTION"
+This call gets or sets the mixing levels for a stream.
+
+\fBNOTE: This call is not marked as forzen, it's interface may change in newer versions!\fR
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+The connection to the roar audio server.
+
+.TP
+\fBid\fR
+The ID of the stream to change.
+
+\fBNOTE:\fR the type of this argument may change in newer versions of the lib!
+
+.TP
+\fBmixer\fR
+FIXME
+
+.TP
+\fBchannels\fR
+FIXME
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_server_oinfo.3
===================================================================
--- doc/man3/roar_server_oinfo.3	(revision 159)
+++ doc/man3/roar_server_oinfo.3	(revision 159)
@@ -0,0 +1,39 @@
+.\" roar_simple_play.3:
+
+.TH "roar_server_oinfo" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_server_oinfo \- Gets information on the output stream of RoarAudio's sound server
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_server_oinfo(struct roar_connection * con, struct roar_stream * s);
+
+.SH "DESCRIPTION"
+Gets information on the output stream of the sound server. The output stream is the stream it sends
+to the soundcard. This can be used to get optimal parameters for all operations so the server don't need to resample.
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+The connection to the server.
+
+.TP
+\fBs\fR
+A stream object to be filled with information on the output stream.
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBroar_simple_filter\fR(3),
+\fBroar_simple_monitor\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_simple_close.3
===================================================================
--- doc/man3/roar_simple_close.3	(revision 159)
+++ doc/man3/roar_simple_close.3	(revision 159)
@@ -0,0 +1,38 @@
+.\" roar_simple_play.3:
+
+.TH "roar_simple_close" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_simple_close \- close a simple RoarAudio connection
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_simple_close(int fh);
+
+.SH "DESCRIPTION"
+Closes a filehandle opened via \fBroar_simple_play\fR(3), \fBroar_simple_monitor\fR(3), \fBroar_simple_record\fR(3), \fBroar_simple_filter\fR(3) or \fBroar_simple_new_stream\fR(3).
+
+.SH "PARAMETERS"
+.TP
+\fBfh\fR
+The filehandle to be closed.
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+Examples of these calls are the tools \fBroarcat\fR(1), \fBroarmon\fR(1), \fBroarrec\fR(1) and \fBroarfilt\fR(1).
+Just look at there code. They aren't that complex.
+
+.SH "SEE ALSO"
+\fBroar_simple_play\fR(3),
+\fBroar_simple_monitor\fR(3),
+\fBroar_simple_record\fR(3),
+\fBroar_simple_filter\fR(3),
+\fBroar_simple_new_stream\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_simple_connect.3
===================================================================
--- doc/man3/roar_simple_connect.3	(revision 159)
+++ doc/man3/roar_simple_connect.3	(revision 159)
@@ -0,0 +1,45 @@
+.\" roar_simple_play.3:
+
+.TH "roar_simple_connect" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_simple_connect \- Opens a connection to RoarAudio's sound server
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_simple_connect (struct roar_connection * con, char * server, char * name);
+
+.SH "DESCRIPTION"
+This call opens a connection to the RoarAudio's sound server. This is usefull for controlling the server or
+update meta data of any kind. For simple playback see \fBroar_simple_play\fR(3).
+To disconnect use \fBroar_disconnect\fR(3).
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+The roar_connection object to be filled on success with all data needed for comunicating with the server.
+This is used by nearly all other functions.
+
+.TP
+\fBserver\fR
+The host or filename of the socket of the server. Should normaly be \fBNULL\fR to try default locations.
+
+.TP
+\fBname\fR
+The name of this client. Should be the name of the player without any paths or filenames.
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBroar_disconnect\fR(3),
+\fBroar_simple_play\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_simple_get_standby.3
===================================================================
--- doc/man3/roar_simple_get_standby.3	(revision 159)
+++ doc/man3/roar_simple_get_standby.3	(revision 159)
@@ -0,0 +1,32 @@
+.\" roar_simple_play.3:
+
+.TH "roar_simple_get_standby" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_simple_get_standby \- Get RoarAudio's standby state
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_simple_get_standby(int fh);
+
+.SH "DESCRIPTION"
+Asks the server for it's standby state.
+
+.SH "PARAMETERS"
+.TP
+\fBfh\fR
+FIXME
+
+.SH "RETURN VALUE"
+On success this call return \fBROAR_STANDBY_ACTIVE\fR or \fBROAR_STANDBY_INACTIVE\fR.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_simple_new_stream.3
===================================================================
--- doc/man3/roar_simple_new_stream.3	(revision 159)
+++ doc/man3/roar_simple_new_stream.3	(revision 159)
@@ -0,0 +1,53 @@
+.\" roar_simple_play.3:
+
+.TH "roar_simple_new_stream" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_simple_new_stream, roar_simple_new_stream_obj \- Create a new stream via RoarAudio
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_simple_new_stream(struct roar_connection * con, int rate, int channels, int bits, int codec, int dir);
+
+int roar_simple_new_stream_obj(struct roar_connection * con, struct roar_stream * s, int rate, int channels, int bits, int
+codec, int dir);
+
+.SH "DESCRIPTION"
+Opens a new stream to the sound server as a independet file handle (not an execed one). This is usefull if you still want
+some meta data or the volume to be updated after the stream is open.
+
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+The "parent" connection. This is a valid open controll connection as opend via \fBroar_simple_connect\fR(3).
+
+.TP
+\fBs\fR
+The stream object to be updated to corresponde to the new stream. This is usefull if use want to update some meta data
+after the stream has be opened as you can use all controll commands on this object.
+
+.TP
+\fBrate, channels, bits, codec\fR
+For an explanation on these parameters see \fBroar_simple_play\fR(3).
+
+.TP
+\fBdir\fR
+For an explanation on this parameter see \fBroar_simple_stream\fR(3).
+
+.SH "RETURN VALUE"
+On success these calls return a new filehandle.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+An example of the use of \fBroar_simple_new_stream_obj()\fR can be found on \fBroarvorbis\fR(1) code.
+
+.SH "SEE ALSO"
+\fBroar_simple_connect\fR(3),
+\fBroar_simple_play\fR(3),
+\fBroar_simple_close\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_simple_stream.3
===================================================================
--- doc/man3/roar_simple_stream.3	(revision 159)
+++ doc/man3/roar_simple_stream.3	(revision 159)
@@ -0,0 +1,63 @@
+.\" roar_simple_play.3:
+
+.TH "roar_simple_stream" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_simple_stream \- Opens a stream to RoarAudio's sound server
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_simple_stream(int rate, int channels, int bits, int codec, char * server, int dir, char * name);
+
+.SH "DESCRIPTION"
+This creates a new stream to RoarAudio. Normaly you want to use one of \fBroar_simple_play\fR(3), \fBroar_simple_monitor\fR(3), \fBroar_simple_record\fR(3) or \fBroar_simple_filter\fR(3).
+
+.SH "PARAMETERS"
+.TP
+\fBrate, channels, bits, codec, server, name\fR
+For an explanation on these parameters see \fBroar_simple_play\fR(3).
+
+.TP
+\fBdir\fR
+The direction of the new stream. See below for a list of valid directions.
+
+.SH "STREAM DIRECTIONS"
+
+.TP
+\fBROAR_DIR_PLAY\fR
+This stream directions meens that a player streams data to the server in order to play it back.
+
+.TP
+\fBROAR_DIR_RECORD\fR
+This direction is to record audio from the soundcard. This is used if for example you want to
+get data from your microphon or line in.
+
+.TP
+\fBROAR_DIR_MONITOR\fR
+This direction is used to get a copy of what the server sends to the soundcard. This can for example be used
+to stream the fully mixed data to Icecast (see \fBicecast2\fR(1)).
+
+.TP
+\fBROAR_DIR_FILTER\fR
+This is used to crate a filter stream: A filter stream is a stream used to filter the output of the sound server by some tool. This can for example be used for an software equalizer. The filter stream is the only bi-directional stream. You have to read some data and write back data of exactly the same size.
+
+.TP
+\fBROAR_DIR_OUTPUT\fR
+This is the type of the stream the server sends to the soundcard. You can not create such a stream. It's only listend for completeness.
+
+
+.SH "RETURN VALUE"
+On success these calls return a filehandle.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBroar_simple_play\fR(3),
+\fBroar_simple_close\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_socket_listen.3
===================================================================
--- doc/man3/roar_socket_listen.3	(revision 159)
+++ doc/man3/roar_socket_listen.3	(revision 159)
@@ -0,0 +1,79 @@
+.\" roar_simple_play.3:
+
+.TH "roar_socket_listen" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_socket_listen \- Opens a new listen socket
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_socket_listen(int type, char * host, int port);
+
+.SH "DESCRIPTION"
+Opens a new listening socket for network clients to connect to.
+You may accept new connections via \fBaccept\fR(2).
+
+.SH "PARAMETERS"
+.TP
+\fBtype\fR
+The type of the Socket. See the list below.
+
+.TP
+\fBhost\fR
+The host or path name to listen on.
+This depends on the type argument.
+For TCP/IP to listen on any interface use a value of "0.0.0.0".
+
+.TP
+\fBport\fR
+The port number to listen on.
+This may be ignored by types not supporting port numbers.
+
+.SH "SOCKET TYPES"
+.TP
+\fBROAR_SOCKET_TYPE_UNKNOWN\fR
+The type will be auto detected. Don't use this if you know the type. Only use this
+to support user given addresses and enable auto detection.
+
+.TP
+\fBROAR_SOCKET_TYPE_TCP\fR
+Use a TCP/IP connection. This is standard mode for networking.
+\fBhost\fR is the hostname or IP to listen on and \fBport\fR is the port number to use.
+
+.TP
+\fBROAR_SOCKET_TYPE_INET\fR
+Same as above but deprecated. Use \fBROAR_SOCKET_TYPE_TCP\fR.
+
+.TP
+\fBROAR_SOCKET_TYPE_UNIX\fR
+UNIX Domain Socket. This should be default for local connections.
+\fBhost\fR is the filename of the socket.
+
+.TP
+\fBROAR_SOCKET_TYPE_FORK\fR
+This is to fork a roard to communicate with. Can't be use to listen on, just to connect to.
+\fBhost\fR and \fBport\fR is ignored at the moment.
+
+.TP
+\fBROAR_SOCKET_TYPE_FILE\fR
+This is used to open a plain file. Can't be use to listen on, just to connect to.
+\fBhost\fR is the filename to connect to.
+
+
+.SH "RETURN VALUE"
+On success these calls return filehandle.  On error, -1 is returned.
+
+.SH "BUGS"
+Listening on UDP sockets is not supported at the moment.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBaccept\fR(2),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_socket_nonblock.3
===================================================================
--- doc/man3/roar_socket_nonblock.3	(revision 159)
+++ doc/man3/roar_socket_nonblock.3	(revision 159)
@@ -0,0 +1,38 @@
+.\" roar_simple_play.3:
+
+.TH "roar_socket_nonblock" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_socket_nonblock \- Sets blocking state of a socket
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_socket_nonblock(int fh, int state);
+
+.SH "DESCRIPTION"
+Sets the blocking mode of a given filehandle. For information on nonblocking IO see \fBopen\fR(2) an look for \fBO_NONBLOCK\fR.
+
+.SH "PARAMETERS"
+.TP
+\fBfh\fR
+The filehandle to set the new state on.
+
+.TP
+\fBstate\fR
+The new state. This may be \fBROAR_SOCKET_BLOCK\fR to sett blocking or \fBROAR_SOCKET_NONBLOCK\fR to set nonblocking mode.
+\fBROAR_SOCKET_NONBLOCK\fR is the same as setting \fBO_NONBLOCK\fR within \fBopen\fR(2).
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBopen\fR(2),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_stream_add_data.3
===================================================================
--- doc/man3/roar_stream_add_data.3	(revision 159)
+++ doc/man3/roar_stream_add_data.3	(revision 159)
@@ -0,0 +1,54 @@
+.\" roar_simple_play.3:
+
+.TH "roar_stream_add_data" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_stream_add_data \- Adds data to a stream's input buffer using the controll connection
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_stream_add_data(struct roar_connection * con, struct roar_stream * s, char * data, size_t len);
+
+.SH "DESCRIPTION"
+This adds data to the input buffer of a stream. It's like doing some thing like this:
+
+ write(stream_fh, data, len);
+
+but uses the controll channel to add the data.
+
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+The connection to the server.
+
+.TP
+\fBs\fR
+The stream to add data to it's input buffer.
+
+.TP
+\fBdata\fR
+The data to add to the buffer.
+
+.TP
+\fBlen\fR
+The length of the data to be added.
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "BUGS"
+This call doesn't work with the current roard. The server does not use all of the buffer size and
+complains about unterruns.
+
+.SH "SEE ALSO"
+\fBwrite\fR(2),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_stream_connect.3
===================================================================
--- doc/man3/roar_stream_connect.3	(revision 159)
+++ doc/man3/roar_stream_connect.3	(revision 159)
@@ -0,0 +1,44 @@
+.\" roar_simple_play.3:
+
+.TH "roar_stream_connect" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_stream_connect \- Connect a stream to RoarAudio's sound server
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_stream_connect(struct roar_connection * con, struct roar_stream * s, int dir);
+
+.SH "DESCRIPTION"
+This connects a new stream as created by \fBroar_stream_new\fR(3) to the server.
+
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+The connection to the sound server
+
+.TP
+\fBs\fR
+The stream object to connect.
+
+.TP
+\fBdir\fR
+The direction of the new stream.
+See \fBroar_simple_stream\fR(3) for details.
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBroar_stream_new\fR(3),
+\fBroar_simple_stream\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_stream_connect_to.3
===================================================================
--- doc/man3/roar_stream_connect_to.3	(revision 159)
+++ doc/man3/roar_stream_connect_to.3	(revision 159)
@@ -0,0 +1,54 @@
+.\" roar_simple_play.3:
+
+.TH "roar_stream_connect_to" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_stream_connect_to \- Connects a stream to some listening socket
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_stream_connect_to(struct roar_connection * con, struct roar_stream * s, int type, char * host, int port);
+
+.SH "DESCRIPTION"
+This let the sound server connect to some remote end to get it's data for a stream.
+This is used internaly to open additional streams for \fBroar_simple_new_stream\fR(3).
+
+\fBNOTE:\fR
+This is not an alternative version of \fBroar_stream_connect\fR(3). You still need to connect the stream to the server via
+\fBroar_stream_connect\fR(3) before you can use this call.
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+The connection to the server.
+
+.TP
+\fBs\fR
+The stream to connect.
+
+.TP
+\fBtype\fR, \fBhost\fR, \fBport\fR
+Where the stream should be connected to.
+For a description of all these parameters see \fBroar_socket_listen\fR(3).
+
+.SH "NOTES"
+This call will block untill the server process to connect to has accepted the connection.
+This makes this call unusable to connect back to us if we are not threaded. For a nonblocking call
+see \fBroar_stream_connect_to_ask\fR(3).
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBroar_simple_new_stream\fR(3),
+\fBroar_stream_connect\fR(3),
+\fBroar_socket_listen\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_stream_exec.3
===================================================================
--- doc/man3/roar_stream_exec.3	(revision 159)
+++ doc/man3/roar_stream_exec.3	(revision 159)
@@ -0,0 +1,42 @@
+.\" roar_simple_play.3:
+
+.TH "roar_stream_exec" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_stream_exec \- Set a stream as master stream of a client
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_stream_exec(struct roar_connection * con, struct roar_stream * s);
+
+.SH "DESCRIPTION"
+This sets a stream to be the master stream of a client.
+A master stream is a stream send via the client's controll channel.
+If a master stream is closed the client and all it's streams are closed.
+Setting a master stream can not be undone nor can any controll commands be send
+anymore. This is used mainly for opening a connection for just playback without
+need to change things later like \fBroar_simple_play\fR(3) does it.
+
+.SH "PARAMETERS"
+.TP
+\fBcon\fR
+The connection to the server.
+
+.TP
+\fBs\fR
+The stream to be set as master stream.
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBroar_simple_play\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
Index: doc/man3/roar_stream_new.3
===================================================================
--- doc/man3/roar_stream_new.3	(revision 159)
+++ doc/man3/roar_stream_new.3	(revision 159)
@@ -0,0 +1,33 @@
+.\" roar_simple_play.3:
+
+.TH "roar_stream_new" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido"
+
+.SH NAME
+roar_stream_new \- creates a new stream object
+
+.SH SYNOPSIS
+
+#include <roaraudio.h>
+
+int roar_stream_new(struct roar_stream * s, unsigned int rate, unsigned int channels, unsigned int bits, unsigned int codec);
+
+.SH "DESCRIPTION"
+This call create a new stream object.
+
+.SH "PARAMETERS"
+The parameter \fBs\fR is a pointer to the new stream object.
+
+For a description of the other parameters see \fBroar_simple_play\fR(3).
+
+.SH "RETURN VALUE"
+On success these calls return 0.  On error, -1 is returned.
+
+.SH "EXAMPLES"
+FIXME
+
+.SH "SEE ALSO"
+\fBroar_simple_play\fR(3),
+\fBlibroar\fR(7),
+\fBRoarAudio\fR(7).
+
+.\" ll
