add man pages

Signed-off-by: Mattias Andrée <maandree@member.fsf.org>

4 files changed, 99 insertions, 1 deletions

diff --git a/Makefile.in b/Makefile.in
index 71d133e..86e6088 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -53,6 +53,11 @@ _H = libhaiku
 _HEADER_DIRLEVELS = 1
 _CPPFLAGS = -D'PACKAGE="$(PKGNAME)"' -D'PROGRAM_VERSION="$(_VERSION)"'
 
+# Used by mk/man.mk
+_MAN_PAGE_SECTIONS = 3 7
+_MAN_3 = libhaiku_perror
+_MAN_7 = libhaiku
+
 # Used by mk/copy.mk
 _COPYING = COPYING
 
diff --git a/configure b/configure
index 219363b..6202ee3 100755
--- a/configure
+++ b/configure
@@ -13,7 +13,6 @@
 
 PKGNAME=libhaiku
 MAN_SECTION_SUFFIX=
-MAN_SECTION=1
 
 
 list_optional_features_help ()
diff --git a/doc/man/libhaiku.7 b/doc/man/libhaiku.7
new file mode 100644
index 0000000..d6eee8d
--- /dev/null
+++ b/doc/man/libhaiku.7
@@ -0,0 +1,34 @@
+.TH LIBHAIKU 7 LIBHAIKU
+.SH NAME
+libhaiku \- Poetic error messages
+.SH DESCRIPTION
+.B libhaiku
+is an API on top of a collection of haiku, thats lets a programmer
+make a program print haiku for error messages. Instead of calling
+.BR perror (3),
+the program should call
+.BR libhaiku_perror (3).
+.SH "SEE ALSO"
+.BR libhaiku_perror (3),
+.BR perror (3)
+.SH "KNOWN ISSUES"
+Must of the haiku uses 5\-7\-5 syllables rather than 5\-7\-5 morae.
+This is however of lesser importance, as it is much harder to write
+a 5\-7\-5 mora haiku than a 5\-7\-5 syllable haiku.
+.SH LICENSE
+Copyright \(co 2016  Mattias Andrée
+.br
+License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+.br
+There is NO WARRANTY, to the extent permitted by law.
+.PP
+Copying and distribution of this manual, with or without modification,
+are permitted in any medium without royalty provided the copyright
+notice and this notice are preserved.  This file is offered as-is,
+without any warranty.
+.SH BUGS
+Please report bugs to <https://github.com/maandree/libhaiku/issues>
+or to <maandree@member.fsf.org>.
+
diff --git a/doc/man/libhaiku_perror.3 b/doc/man/libhaiku_perror.3
new file mode 100644
index 0000000..7c0476d
--- /dev/null
+++ b/doc/man/libhaiku_perror.3
@@ -0,0 +1,60 @@
+.TH LIBHAIKU_PERROR 3 LIBHAIKU
+.SH NAME
+libhaiku_perror \- Print a poetic error message
+.SH SYNOPSIS
+.nf
+#include <libhaiku.h>
+
+void \fBlibhaiku_perror\fP(const char *\fIs\fP);
+.fi
+.PP
+Link with
+.IR \-lhaiku .
+.SH DESCRIPTION
+.B libhaiku_perror
+shall print an error message in the format of a haiku, appropriate
+for the current value of
+.BR errno .
+If there is not haiku available for the current value of
+.BR errno ,
+.B libhaiku_perror
+shall call
+.BR perror (3)
+with
+.I s
+as its argument unless
+.I s
+is
+.BR NULL ,
+and then print a generic haiku.
+.PP
+Unlike
+.BR perror (3),
+.B libhaiku_perror
+shall not print anything if
+.B errno
+is zero.
+.SH "SEE ALSO"
+.BR libhaiku (7),
+.BR perror (3)
+.SH "KNOWN ISSUES"
+Must of the haiku uses 5\-7\-5 syllables rather than 5\-7\-5 morae.
+This is however of lesser importance, as it is much harder to write
+a 5\-7\-5 mora haiku than a 5\-7\-5 syllable haiku.
+.SH LICENSE
+Copyright \(co 2016  Mattias Andrée
+.br
+License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+.br
+There is NO WARRANTY, to the extent permitted by law.
+.PP
+Copying and distribution of this manual, with or without modification,
+are permitted in any medium without royalty provided the copyright
+notice and this notice are preserved.  This file is offered as-is,
+without any warranty.
+.SH BUGS
+Please report bugs to <https://github.com/maandree/libhaiku/issues>
+or to <maandree@member.fsf.org>.
+