1 files changed, 43 insertions, 0 deletions
diff --git a/liblss16_decode_strerror.3 b/liblss16_decode_strerror.3
new file mode 100644
index 0000000..ee011ed
--- /dev/null
+++ b/liblss16_decode_strerror.3
@@ -0,0 +1,43 @@
+.TH LIBLSS16_DECODE_STRERROR 3 LIBLSS16
+.SH NAME
+liblss16_decode_strerror \- Get error description for an LSS16 decoding error
+
+.SH SYNOPSIS
+.nf
+#include <liblss16.h>
+
+enum liblss16_decode_error { /* values omitted */ };
+
+const char *liblss16_decode_strerror(enum liblss16_decode_error \fIerror\fP);
+.fi
+.PP
+Link with
+.IR -llss16 .
+
+.SH DESCRIPTION
+The
+.BR liblss16_decode_strerror ()
+function returns a stirng the describes
+.IR error .
+.PP
+The function is used for decoding errors, which may be
+received from the
+.BR liblss16_decode_to_colour_index (3)
+function.
+
+.SH RETURN VALUE
+The
+.BR liblss16_decode_strerror ()
+function returns a statically allocated single-line
+of text (not LF-terminated) describing the error, in
+sentence case, single-sentence (not period-terminated).
+If the error code is not recognised, a generic text
+is returned.
+
+.SH ERRORS
+The
+.BR liblss16_decode_strerror ()
+function cannot fail.
+
+.SH SEE ALSO
+.BR liblss16 (7)