This shows you the differences between two versions of the page.
— |
xecho [2018/04/11 18:20] (current) |
||
---|---|---|---|
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 =- | ||