Contents:

• Usage
• Description
• Example
• Options
• Limitations
• Return Codes
• Version History
• TextTools main page

acho [log logfile] [option] arg [...]

See Understanding The Usage Section for details.

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.

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.

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.

acho requires a colour display.

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.

These are the released versions of acho:

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 did not 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.
1.31	21-Oct-00	DOS version discontinued.