6 Colorize aims at being a small, independent and handy command-line
7 text colorizing tool. It emits ANSI escape sequences in order to
8 color lines of text; also, sequences emitted by colorize or foreign
9 programs may be cleared.
11 The main code is written in C (c89 mostly), whereas the test script
12 consists of Perl code.
14 Colorize is known to build and test successfully on Linux and
15 Net/Open/MirBSD. Other platforms are untested, so be prepared for
16 it to eventually not work as expected there.
26 Issue `make' to build colorize.
28 Once completed, run the tests with `make check'.
30 Then you should most likely have a working binary. There are
31 currently no make targets to install it as such.
33 Finally, remove it through `make clean'.
35 Debugging instructions
36 ----------------------
37 For the sake of completeness, colorize can be also built with
38 debugging output by issuing `make FLAGS=-DDEBUG'. The intention
39 is to provide some memory allocation diagnostics (and might be
40 extended in future). Usually, a debugging build is not required.
44 See man page source file: colorize.1.
51 | ls "$@" | colorize green -
55 This excerpt defines an alias which will set the color being
56 printed for literal ls invocations to green.
60 Let me know, if you have ideas, bug reports, patches, etc.
64 Steven Schubiger <stsc@refcnt.org>