From a1a1d9ed137c8e404e7f0bd41804099ef18b9267 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Mon, 29 Feb 2016 15:34:38 +0100 Subject: Add a number of man pages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- man/libzahl.7 | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 man/libzahl.7 (limited to 'man/libzahl.7') diff --git a/man/libzahl.7 b/man/libzahl.7 new file mode 100644 index 0000000..d7a9728 --- /dev/null +++ b/man/libzahl.7 @@ -0,0 +1,37 @@ +.TH LIBZAHL 7 libzahl +.SH NAME +libzahl - Big integer library +.SH ETYMOLOGY +The bold uppercase \(aqZ\(aq which represents the +set of all integers is derived from the german word +\(aqzahlen\(aq, whose singular is \(aqzahl\(aq. +.SH DESCRIPTION +.B libzahl +is a C library for arbitrary size integers, that +aims to be usable for rubust programs, and be +fast. +.P +.B libzahl +will accomplish this by using long jumps when an +error is detected, rather than letting the caller +also perform a check. This shall make the code in +the user program cleaner too. +.B libzahl +will use dedicated temporary bignum integers whether +possible, and necessary, for its internal calculations. +.B libzahl +will not deallocate allocations, but rather cache +them for reuse. +.P +With the exception of functions working with strings, +all output parameters are before the input parameters. +.SH RATIONALE +GMP MP cannot be used for rubust programs. LibTomMath +is too slow, probably because of all memory allocations, +and has an nonintuitive API. Hebimath is promising, but +I think it can be done better. +.SH NOTES +.B libzahl +is currently not thread-safe. +.SH SEE ALSO +.BR zsetup (3) -- cgit v1.2.3-70-g09d2