Mon, 20 Apr 2020 10:14:32 -0500
Convert README to markdown
README | file | annotate | diff | comparison | revisions | |
README.md | file | annotate | diff | comparison | revisions |
--- a/README Thu Feb 06 23:36:29 2014 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,33 +0,0 @@ - -libtu - -Copyright (c) Tuomo Valkonen 1999-2007. -<tuomov at iki.fi> - - -Libtu is a small utility library for programs written in C. - -Most of this library may be distributed and modified under either under -the Clarified Artistic License or the GNU LGPL, version 2.1 or later, -both reproduced in the file LICENSE. The red-black tree code is under -the GNU LGPL; see README.rb for details. - -To build the library, first edit system.mk to customize it for your -system if necessary. Then 'make depend && make'. -To install it run 'make install' (perhaps as root depending on -where you are installing it). - -If you want to use it in your programs, you may try to figure out how -by reading the header files (include/*.h) and test programs (tester*.c). -Or you could try urging me to write some sort of a manual. - ---- - -Libtu needs the functions asprintf and vasprintf. These do not -exist on most platforms. One implementation by Mark Martinec -is included in snprintf_2.2/ and is used by default. To use the -system's versions of these functions, if available, modify -system.mk. - -The implementation of red-black trees is based on that by -James S. Plank; see README.rb for details.
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.md Mon Apr 20 10:14:32 2020 -0500 @@ -0,0 +1,31 @@ + +# libtu + +Written 1999–2007 by Tuomo Valkonen <tuomov@iki.fi> + +Libtu is a small utility library for programs written in C, used by my old C codes. + +Most of this library may be distributed and modified under either under +the Clarified Artistic License or the GNU LGPL, version 2.1 or later, +both reproduced in the file LICENSE. The red-black tree code is under +the GNU LGPL; see `README.rb` for details. + +To build the library, first edit system.mk to customize it for your +system if necessary. Then `make depend && make`. +To install it run `make install` (perhaps as root depending on +where you are installing it). + +If you want to use it in your programs, you may try to figure out how +by reading the header files (`include/*.h`) and test programs (`tester*.c`). +Or you could try urging me to write some sort of a manual. + +## Requisites + +Libtu needs the functions asprintf and vasprintf. These do not +exist on most platforms. One implementation by Mark Martinec +is included in `snprintf_2.2/` and is used by default. To use the +system's versions of these functions, if available, modify +system.mk. + +The implementation of red-black trees is based on that by +James S. Plank; see `README.rb` for details.