From eccc4a4bfeb0b2a37d55511de962f53c86324abb Mon Sep 17 00:00:00 2001
From: Sean Middleditch <sean@middleditch.us>
Date: Sat, 24 Oct 2009 14:53:12 -0700
Subject: initial man pages, bump to 0.13

---
 Makefile.am   |  2 ++
 NEWS          |  4 ++++
 configure.ac  |  2 +-
 libtelnet.3   | 41 +++++++++++++++++++++++++++++++++++++++++
 telnet_free.3 | 19 +++++++++++++++++++
 telnet_init.3 | 41 +++++++++++++++++++++++++++++++++++++++++
 6 files changed, 108 insertions(+), 1 deletion(-)
 create mode 100644 libtelnet.3
 create mode 100644 telnet_free.3
 create mode 100644 telnet_init.3

diff --git a/Makefile.am b/Makefile.am
index e9a0039..60ebd2f 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,6 +1,8 @@
 pkgconfigdir = $(libdir)/pkgconfig
 pkgconfig_DATA = libtelnet.pc
 
+dist_man_MANS = libtelnet.3 telnet_init.3 telnet_free.3
+
 libtelnet_includedir = $(includedir)
 libtelnet_include_HEADERS = libtelnet.h
 
diff --git a/NEWS b/NEWS
index 97ff949..cf5bdb4 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,7 @@
+Version 0.13
+============
+* added basic man pages
+
 Version 0.12
 ============
 
diff --git a/configure.ac b/configure.ac
index 3285f95..a90df35 100644
--- a/configure.ac
+++ b/configure.ac
@@ -1,4 +1,4 @@
-AC_INIT([libtelnet], [0.12], [http://github.com/elanthis/libtelnet/tree/master])
+AC_INIT([libtelnet], [0.13], [http://github.com/elanthis/libtelnet/tree/master])
 
 AM_INIT_AUTOMAKE
 
diff --git a/libtelnet.3 b/libtelnet.3
new file mode 100644
index 0000000..f73dc84
--- /dev/null
+++ b/libtelnet.3
@@ -0,0 +1,41 @@
+.TH libtelnet 3 LIBTELNET "" "TELNET Library"
+
+.SH NAME
+\fBlibtelnet\fP - TELNET protocol processing library
+
+.SH SYNOPSIS
+.PP
+\fB#include <libtelnet.h>\fP
+
+.SH DESCRIPTION
+.PP
+\fBlibtelnet\fP is a library for handling the TELNET protocol.  It includes
+routines for parsing incoming data from a remote peer as well as formatting
+data to send to the remote peer.
+
+\fBlibtelnet\fP uses a callback-oriented API, allowing application-specific
+handling of various events.  The callback system is also used for buffering
+outgoing protocol data, allowing the application to maintain control over the
+actual socket connection.
+
+Features supported include the full TELNET protocol, Q-method option
+negotiation, ZMP, MCCP2, MSSP, and NEW-ENVIRON.
+
+.SH CONFORMS TO
+.PP
+RFC854  - http://www.faqs.org/rfcs/rfc854.html
+.br
+RFC855  - http://www.faqs.org/rfcs/rfc855.html
+.br
+RFC1091 - http://www.faqs.org/rfcs/rfc1091.html
+.br
+RFC1143 - http://www.faqs.org/rfcs/rfc1143.html
+.br
+RFC1408 - http://www.faqs.org/rfcs/rfc1408.html
+.br
+RFC1572 - http://www.faqs.org/rfcs/rfc1572.html
+
+.SH SEE ALSO
+.PP
+\fBtelnet_init\fR(3), \fBtelnet_free\fR(3), \fBtelnet_send\fR,
+\fBtelnet_recv\fR
diff --git a/telnet_free.3 b/telnet_free.3
new file mode 100644
index 0000000..b0cb313
--- /dev/null
+++ b/telnet_free.3
@@ -0,0 +1,19 @@
+.TH telnet_init 3 LIBTELNET "" "TELNET Library"
+
+.SH NAME
+\fBtelnet_free\fP - release resources for TELNET state tracker
+
+.SH SYNOPSIS
+.PP
+\fB#include <libtelnet.h>\fP
+.sp
+.B "void telnet_free( telnet_t *\fItelnet\fP );"
+
+.SH DESCRIPTION
+.PP
+The \fBtelnet_free\fP function deallocates resources associated with a prior
+call to \fBtelnet_init\fP.
+
+.SH SEE ALSO
+.PP
+\fBlibtelnet\fR(3), \fBtelnet_init\fR(3)
diff --git a/telnet_init.3 b/telnet_init.3
new file mode 100644
index 0000000..274332a
--- /dev/null
+++ b/telnet_init.3
@@ -0,0 +1,41 @@
+.TH telnet_init 3 LIBTELNET "" "TELNET Library"
+
+.SH NAME
+\fBtelnet_init\fP - initialize a new TELNET connection processor
+
+.SH SYNOPSIS
+.PP
+\fB#include <libtelnet.h>\fP
+.sp
+.B "telnet_t *telnet_init( const telnet_telopt_t *\fItelopts\fP, telnet_event_handler_t \fIeh\fP, unsigned char \fIflags\fP, void *\fIuser_data\fP );"
+
+.SH DESCRIPTION
+.PP
+The \fBtelnet_init\fP function initializes a new TELNET connection processor
+and returns a pointer to the state tracker.
+
+The parameter \fItelopts\fP is an array of telnet_telopt_t structures, which
+defines the list of TELNET options your application supports.  This array must
+include a final entry with all structure element set to 0 to indicate the end
+of the array.
+
+The parameter \fIeh\fP is a pointer to a function to handle all events
+generated by the TELNET processor.
+
+The parameter \fIflags\fP is a set of flags controlling libtelnet's behavior.
+
+The paramater \fIuser_data\fP is an opaque pointer that will be passed to
+the \fIeh\fP function when called.
+
+.SH RETURN VALUES
+.PP
+The return value is a pointer to the libtelnet state tracker, which must be
+passed to all other libtelnet functions regarding this connection.  If
+\fBtelnet_init\fP fails for any reason, it will return NULL instead.
+
+This value must be passed to \fBtelnet_free\fP after the connection is closed
+to free resources used internally by libtelnet.
+
+.SH SEE ALSO
+.PP
+\fBlibtelnet\fR(3), \fBtelnet_free\fR(3)
-- 
cgit v1.2.3