======Synopsis:======
[[xecho]] \\
[[xecho]] //[see options below]// <text>

======Description:======
The [[xecho]] command, just like the [[echo]] command, outputs <text> to your 
display.  Normally text you output with [[xecho]] always appears, even if you
are suppressing the display.  Options are available to give you more control 
over how and where <text> will appear.

======Options:======
| -current          | Output to current server's current window. This is different from the current window (option -visible). |
| -level <level>    | Use the given <level> to hunt for a window, overriding the current level being used.  This option CANCELS the current target, so you must use it before -target.|
| -target           | Use the given <target> to hunt for a window, overriding the current target being used.  The -level option cancels this option, so you must use this option after -level.|
| -line <number>    | When used after -win, overwrite a particular line in that window. |
| -visible          | Output to a visible window.  Usually the current window or the top window on the main screen. |
| -window <windesc> | Output to the specified window. |
| -all              | Output to all windows. |
| -as               | Output to all windows on the server. |
| -banner           | Prefix the <text> with the [[set banner|current banner]] |
| -raw              | Output the <text> as a raw string to the underlying tty.  This is used to send control characters to the terminal emulator. |
| -nolog            | Do not save the <text> to any log files that might apply. |
| -say              | Do not output if display is being suppressed. |
| -x                | Overrule [[set mangle_display]] and pretend it was set to NORMALIZE instead. |
| -f                | Do not [[window notify|notify]] (%F) if the window is hidden |
| -e <seconds>      | After specified number of seconds, echoed line is erased. |
| %%--%%                | End option processing.  <text> begins immediately after this option. |

======Examples:======
To echo text to the current window:
      xecho -v This text will appear in the current window

To send only crap and server notices to a window called `misc'
      xecho -l snotice,crap -w misc This appears in the misc window

To send the message to ALL windows:
      xecho -a This appears in all windows

To send a message with a banner prefixed to the message:
      xecho -b This will give a banner too

To change the titlebar of an xterm: 
      eval xecho -r $chr(27)]2\;Your titlebar has been changed.$chr(7)

To output a temporary message:
      xecho -e 5 This message will self destruct in 5 seconds!

To output text beginning with a hyphen:
      xecho -- -= This text is treated literal =-
outputs:

-= This text is treated literal =-