Site Tools


xecho
no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.


xecho [2018/04/11 18:20] (current) – created - external edit 127.0.0.1
Line 1: Line 1:
 +======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 =-
  
xecho.txt · Last modified: 2018/04/11 18:20 by 127.0.0.1