]> git.refcnt.org Git - colorize.git/blob - README
First draft of README
[colorize.git] / README
1 colorize
2 ========
3
4 Description
5 -----------
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.
10
11 The main code is written in C (c89 mostly), whereas the test script
12 consists of Perl code.
13
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.
17
18 Requirements
19 ------------
20 gcc
21 make
22 perl
23
24 Build instructions
25 ------------------
26 Issue `make' to build colorize.
27
28 Once completed, run the tests with `make check'.
29
30 Then you should most likely have a working binary. There are
31 currently no make targets to install it as such.
32
33 Finally, remove it through `make clean'.
34
35 Documentation
36 -------------
37 See man page source file: colorize.1.
38
39 Afterword
40 ---------
41 Let me know, if you have ideas, bug reports, patches, etc.
42
43 Author
44 ------
45 Steven Schubiger <stsc@refcnt.org>