X-Git-Url: http://git.refcnt.org/?a=blobdiff_plain;f=README;h=afd40b9209282b0b3c96c0c6c52599f0799c8b32;hb=1782f59161b19c43593815903b4226d5adfef737;hp=12656376935b5867e49b79c1176fb1db233d5ff6;hpb=a4a170bb3a39da6e246708d53435e902cfb1c189;p=colorize.git

diff --git a/README b/README
index 1265637..afd40b9 100644
--- a/README
+++ b/README
@@ -32,10 +32,29 @@ currently no make targets to install it as such.
 
 Finally, remove it through `make clean'.
 
+Debugging instructions
+----------------------
+For the sake of completeness, colorize can be also built with
+debugging output by issuing `make FLAGS=-DDEBUG'.  The intention
+is to provide some memory allocation diagnostics (and might be
+extended in future).  Usually, a debugging build is not required.
+
 Documentation
 -------------
 See man page source file: colorize.1.
 
+Usage example
+-------------
+In ~/.bashrc:
+
+| ls_color() {
+|     ls "$@" | colorize green -
+| }
+| alias ls=ls_color
+
+This excerpt defines an alias which will set the color being
+printed for literal ls invocations to green.
+
 Afterword
 ---------
 Let me know, if you have ideas, bug reports, patches, etc.