aboutsummaryrefslogtreecommitdiffstats
path: root/doc/info/chap/overview.texinfo
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2021-03-01 02:12:47 +0100
committerMattias Andrée <maandree@kth.se>2021-03-01 02:12:58 +0100
commiteebadeb4b4ee60dc768afd3036e3a29833ccb51e (patch)
treee20184a304c0ba1160477b644504fbb2e8146319 /doc/info/chap/overview.texinfo
parentfix build (diff)
downloadlibhaiku-eebadeb4b4ee60dc768afd3036e3a29833ccb51e.tar.gz
libhaiku-eebadeb4b4ee60dc768afd3036e3a29833ccb51e.tar.bz2
libhaiku-eebadeb4b4ee60dc768afd3036e3a29833ccb51e.tar.xz
misc + change license + changed behaviour of libhaiku_perror
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'doc/info/chap/overview.texinfo')
-rw-r--r--doc/info/chap/overview.texinfo38
1 files changed, 0 insertions, 38 deletions
diff --git a/doc/info/chap/overview.texinfo b/doc/info/chap/overview.texinfo
deleted file mode 100644
index 9e44ffb..0000000
--- a/doc/info/chap/overview.texinfo
+++ /dev/null
@@ -1,38 +0,0 @@
-@node Overview
-@chapter Overview
-
-@command{libhaiku} is a simply error message printing C library
-with a collection of haiku that it prints instead of traditional
-error messages.
-
-A known issue is that must of the haiku uses 5--7--5@tie{}syllables
-rather than 5--7--5@tie{}morae. This is however of lesser importance,
-as it is much harder to write a 5--7--5@tie{}mora haiku than a
-5--7--5@tie{}syllable haiku.
-
-To use @command{libhaiku} include the head file @file{<libhaiku.h>}
-and link with @option{-lhaiku}. The function
-@example
-void libhaiku_perror(const char* s);
-@end example
-is used to print the error
-messages. @code{libhaiku_perror} shall print an error message in the
-format of a haiku, appropriate for the current value of @code{errno}.
-If there is not haiku available for the current value of @code{errno},
-@code{libhaiku_perror} shall call @code{perror} with @code{s} as its
-argument unless @code{s} is @code{NULL}, and then print a generic haiku.
-
-Unlike @code{perror}, @code{libhaiku_perror} shall not print anything
-if @code{errno} is zero. If you rather it did, you can use the macro
-
-@example
-#define libhaiku_perror(s) \
- do @{ \
- const char *s__ = (s); \
- if (errno && s__) \
- perror(s__); \
- errno = errno ? errno : -1; \
- libhaiku_perror(0); \
- @} while (0)
-@end example
-