X-Git-Url: http://git.refcnt.org/?p=colorize.git;a=blobdiff_plain;f=README;fp=README;h=12656376935b5867e49b79c1176fb1db233d5ff6;hp=0000000000000000000000000000000000000000;hb=a4a170bb3a39da6e246708d53435e902cfb1c189;hpb=9a1c3657772d04b82aee08b30af9c53e2f2c7a3e diff --git a/README b/README new file mode 100644 index 0000000..1265637 --- /dev/null +++ b/README @@ -0,0 +1,45 @@ +colorize +======== + +Description +----------- +Colorize aims at being a small, independent and handy command-line +text colorizing tool. It emits ANSI escape sequences in order to +color lines of text; also, sequences emitted by colorize or foreign +programs may be cleared. + +The main code is written in C (c89 mostly), whereas the test script +consists of Perl code. + +Colorize is known to build and test successfully on Linux and +Net/Open/MirBSD. Other platforms are untested, so be prepared for +it to eventually not work as expected there. + +Requirements +------------ +gcc +make +perl + +Build instructions +------------------ +Issue `make' to build colorize. + +Once completed, run the tests with `make check'. + +Then you should most likely have a working binary. There are +currently no make targets to install it as such. + +Finally, remove it through `make clean'. + +Documentation +------------- +See man page source file: colorize.1. + +Afterword +--------- +Let me know, if you have ideas, bug reports, patches, etc. + +Author +------ +Steven Schubiger