diff options
author | Mattias Andrée <maandree@kth.se> | 2021-03-01 02:12:47 +0100 |
---|---|---|
committer | Mattias Andrée <maandree@kth.se> | 2021-03-01 02:12:58 +0100 |
commit | eebadeb4b4ee60dc768afd3036e3a29833ccb51e (patch) | |
tree | e20184a304c0ba1160477b644504fbb2e8146319 /doc/info/chap/overview.texinfo | |
parent | fix build (diff) | |
download | libhaiku-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 '')
-rw-r--r-- | doc/info/chap/overview.texinfo | 38 |
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 - |