Documentation

Signed-off-by: Mattias Andrée <maandree@kth.se>

4 files changed, 75 insertions, 0 deletions

diff --git a/man3/LIBAXL_CONNECTION.3 b/man3/LIBAXL_CONNECTION.3
new file mode 100644
index 0000000..c8ebd66
--- /dev/null
+++ b/man3/LIBAXL_CONNECTION.3
@@ -0,0 +1,35 @@
+.TH LIBAXL_CONNECTION 3 libaxl
+.SH NAME
+LIBAXL_CONNECTION - Connection to display server
+.SH SYNOPSIS
+.nf
+#include <libaxl.h>
+
+typedef struct libaxl_connection LIBAXL_CONNECTION;
+.fi
+.SH DESCRIPTION
+The
+.B LIBAXL_CONNECTION
+type definition (also known as
+.BR "struct libaxl_connection" )
+is used by the libaxl library to store the
+state of a connection to an X display server,
+as well as the connection itself to the
+display server.
+.PP
+The library only exposes an incomplete
+definition to of the structure because it
+should be regarded as opaque as it may change
+between versions of the library.
+.PP
+Using the
+.BR libaxl_connect (3)
+function is the easiest way to create a
+connection to the display server; it can
+be disposed with the
+.BR libaxl_close (3)
+function.
+.SH SEE ALSO
+.BR libaxl_connect (3),
+.BR libaxl_close (3),
+.BR LIBAXL_CONTEXT (3)
diff --git a/man3/LIBAXL_CONTEXT.3 b/man3/LIBAXL_CONTEXT.3
new file mode 100644
index 0000000..6b21224
--- /dev/null
+++ b/man3/LIBAXL_CONTEXT.3
@@ -0,0 +1,38 @@
+.TH LIBAXL_CONTEXT 3 libaxl
+.SH NAME
+LIBAXL_CONTEXT - Thread context for connection to display server
+.SH SYNOPSIS
+.nf
+#include <libaxl.h>
+
+typedef struct libaxl_context LIBAXL_CONTEXT;
+.fi
+.SH DESCRIPTION
+The
+.B LIBAXL_CONTEXT
+type definition (also known as
+.BR "struct libaxl_context" )
+is used by the libaxl library to wrap a
+.BR LIBAXL_CONNECTION (3)
+object and store thread-private data.
+All threads running at the same time shall
+access the display server via a unique
+.B LIBAXL_CONTEXT
+object.
+.PP
+The library only exposes an incomplete
+definition to of the structure because it
+should be regarded as opaque as it may change
+between versions of the library.
+.PP
+The
+.BR libaxl_context_create (3)
+function is used to create a
+.B LIBAXL_CONTEXT
+object; it can be deallocated with the
+.BR libaxl_context_free (3)
+function.
+.SH SEE ALSO
+.BR libaxl_context_create (3),
+.BR libaxl_context_free (3),
+.BR LIBAXL_CONNECTION (3)
diff --git a/man3/struct_libaxl_connection.3 b/man3/struct_libaxl_connection.3
new file mode 120000
index 0000000..d3d4bd2
--- /dev/null
+++ b/man3/struct_libaxl_connection.3
@@ -0,0 +1 @@
+LIBAXL_CONNECTION.3
\ No newline at end of file
diff --git a/man3/struct_libaxl_context.3 b/man3/struct_libaxl_context.3
new file mode 120000
index 0000000..3db25e0
--- /dev/null
+++ b/man3/struct_libaxl_context.3
@@ -0,0 +1 @@
+LIBAXL_CONTEXT.3
\ No newline at end of file