diff options
author | Steven Schubiger <stsc@refcnt.org> | 2013-04-29 22:01:49 +0200 |
---|---|---|
committer | Steven Schubiger <stsc@refcnt.org> | 2013-04-29 22:01:49 +0200 |
commit | 83c0afb41a3d0f7ff6133b634aba7c3e0242fa69 (patch) | |
tree | 3e13f8b5321077b5ef4f115a1c3542d418eaf5be | |
parent | f7130a441748f7ffd2bb828d665146f46311adb0 (diff) | |
download | colorize-83c0afb41a3d0f7ff6133b634aba7c3e0242fa69.tar.gz colorize-83c0afb41a3d0f7ff6133b634aba7c3e0242fa69.tar.bz2 |
First draft of man page
-rw-r--r-- | colorize.1 | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/colorize.1 b/colorize.1 new file mode 100644 index 0000000..f5b11ec --- /dev/null +++ b/colorize.1 @@ -0,0 +1,43 @@ +.TH COLORIZE 1 "2013-04-29" "colorize v0.50" "User Commands" +.SH NAME +colorize \- colorize text with escape sequences +.SH SYNOPSIS +\fBcolorize\fR [option] (foreground) \fIfile\fR +.PP +\fBcolorize\fR [option] (foreground)/(background) \fIfile\fR +.PP +\fBcolorize\fR \-\-clean[\-all] \fIfile\fR +.PP +\fBcolorize\fR \-hv +.SH DESCRIPTION +Colorizes text read from standard input stream or file by using ANSI +escape sequences (and also vice versa, i.e. cleaning text from sequences) +and prints resulting output to the terminal. +.PP +When colorizing text, (foreground) and eventually (background) may be either +one of following color values: none, black, red, green, yellow, blue, cyan, +magenta, white, default or random. First character of color name in upper +case denotes increased intensity, whereas for lower case colors will be of +normal intensity. If "none" is chosen, no escape sequences will be emitted. +.PP +When de-colorizing text, \-\-clean omits color escape sequences which +were emitted by colorize, whereas \-\-clean\-all omits all valid ones. +If in doubt, consider using \-\-clean\-all. +.SH OPTIONS +.TP +.BR \-\-clean +clean text from color escape sequences emitted by colorize +.TP +.BR \-\-clean\-all +clean text from all valid color escape sequences +.TP +.BR \-\-exclude\-random=\fICOLOR\fR +text color to be excluded when selecting a random foreground color +.TP +.BR \-h ", " \-\-help +show usage screen and exit +.TP +.BR \-v ", " \-\-version +display version data and exit +.SH AUTHOR +Steven Schubiger <stsc@refcnt.org> |