From eebadeb4b4ee60dc768afd3036e3a29833ccb51e Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Mon, 1 Mar 2021 02:12:47 +0100 Subject: misc + change license + changed behaviour of libhaiku_perror MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- doc/info/chap/overview.texinfo | 38 -------------------------------------- 1 file changed, 38 deletions(-) delete mode 100644 doc/info/chap/overview.texinfo (limited to 'doc/info/chap/overview.texinfo') 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{} -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 - -- cgit v1.2.3-70-g09d2