ACHO v1.31 - colourful echo |
Documentation revised 21 Oct 00 - Copyright (c) 1996-2000 by Rune Berg. TextTools Freeware. |
Contents:
Usage | Top || Next |
acho [log logfile] [option] arg [...]
See Understanding The Usage Section for details.
Description | Top || Previous || Next |
acho writes, to standard output, arg ... with the following args changing the console's foreground/background colour:
Argument | Colour change |
---|---|
.n | Normal display (low intensity white on black) |
.o | Original colours and intensity |
.r | Original colours reversed, original intensity |
.hi
.fg=hi |
High intensity foreground |
.lo
.fg=lo |
Low intensity foreground |
.fg=bla | Black foreground |
.fg=red | Red foreground |
.fg=gre | Green foreground |
.fg=yel | Yellow foreground |
.fg=blu | Blue foreground |
.fg=mag | Magenta foreground |
.fg=cya | Cyan foreground |
.fg=whi | White foreground |
.bg=hi | High intensity background |
.bg=lo | Low intensity background |
.bg=bla | Black background |
.bg=red | Red background |
.bg=gre | Green background |
.bg=yel | Yellow background |
.bg=blu | Blue background |
.bg=mag | Magenta background |
.bg=cya | Cyan background |
.bg=whi | White background |
acho still recognizes the .normal, .high, and .rev arguments, for compatability with earlier versions.
acho does not print a space between args.
If you don't specify logfile, acho writes error messages to
standard error.
Example | Top || Previous || Next |
The command:
acho .bg=whi .fg=red "hello world" .n
prints the one-line message "hello world" to the screen in red on white and then resets the display to normal.
Options | Top || Previous || Next |
acho recognizes the following command line options:
Option | Function |
---|---|
-n | Do not print newline after last arg. |
-v | Print version banner and usage info to standard error (or logfile, if given), then exit. |
Unrecognized options are printed.
Limitations | Top || Previous || Next |
acho requires a colour display.
Return Codes | Top || Previous || Next |
acho returns with one of the following codes ("error levels"):
Code | Meaning |
---|---|
0 | Success |
102 | Incorrect/missing command line arguments |
104 | Error opening file |
105 | I/O Error |
107 | File name clash |
110 | Error getting standard output handle. |
For more details, see TextTools General Features.
Version History | Top || Previous |
These are the released versions of acho:
Version | Date | Changes |
---|---|---|
1.01 | 12-Feb-96 | n/a |
1.10 | 26-Sep-96 |
|
1.10 | 11-May-97 |
|
1.20 | 7-Sep-97 |
|
1.30 | 2-Jan-99 |
|
1.31 | 21-Oct-00 |
|
End of document |