| 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 |