| ACHO v1.30 - colourful echo |
| Revised 2-Jan-99. Copyright (c) 1996-99 by Rune Berg. TextTools Freeware. |
Usage | Description | Example | Options | Limitations | Return Codes | Version History | tt_r6
| Usage | Top | Next |
acho [log logfile] [option] arg [...]
| 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 1 |
| .r | Original colours reversed, original intensity |
| .hi
.fg=hi |
High intensity foreground |
| .lo
.fg=lo |
Low intensity foreground 1 |
| .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 1 |
| .bg=lo | Low intensity background 1 |
| .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 |
1 : Only effective for Win32 version.
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 | Don't 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.
To use the DOS version of acho, the ANSI.SYS driver must be loaded. If not already present, add the following line (typically) to your "config.sys" (or "config.nt") file:
DEVICE=C:\DOS\ANSI.SYS
To use the Win32 version of acho, no special setup is needed.
| Return Codes | Top | Previous | Next |
acho returns with one of the following codes ("error levels"):
| Code | Meaning |
|---|---|
| 0 | Success |
| 102 | Incorrect command line arguments |
| 104 | Error opening file |
| 105 | I/O error |
| 110 | Error getting standard output handle |
| Version History | Top | Previous |
These are the released versions:
| Version | Date | Changes |
|---|---|---|
| 1.01 | 12-Feb-96 | n/a |
| 1.10 | 26-Sep-96 | * Very minor changes. |
| 1.10 | 11-May-97 | * Available as Win32 console mode version. |
| 1.20 | 7-Sep-97 | * Proper return codes. * Bug-fix: Win32 version didn't show colours on NT. * Win32 version no longer uses ANSI codes. * Win32 version has additional .xxx directives. |
| 1.30 | 2-Jan-99 | * Win32 version now has coloured response texts. |
| End of document |