User Tools

Site Tools


window_targets

Differences

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

Link to this comparison view

window_targets [2009/06/01 00:47] (current)
Line 1: Line 1:
 +# $EPIC: window_targets.txt,​v 1.1 2009/06/01 00:47:41 jnelson Exp $
 +======Synopsis:​======
 +This page discusses Window Target Lists and how they influence other things.
 +
 +======Description:​======
 +Each window has a list of "irc targets"​ which belong to that window. ​ When a 
 +target is in a window'​s target list, all output regarding that target will 
 +be sent to that window. ​ Usually an "irc target"​ is another user's nickname,
 +but it can be anything that you can send a [[msg]] to.
 +
 +Each target list has a "​current target",​ which is more well known as the 
 +window'​s "​[[window query|query]]"​. ​ The window'​s query is used in these places:
 +
 +  * $querywin(target) will return the window'​s refnum.
 +  * The %Q status bar expando will expand to the current target
 +  * The $Q inline expando expands to the current target
 +  * The $T inline expando expands to the current target instead of the current channel (if you have both)
 +  * /window describe will show the current target as the window'​s query
 +  * /window list will show the current target as the window'​s query
 +  * When you /window log on, and you haven'​t set the /window logfile, then the current target will be used as part of the default hostname.
 +  * $windowctl(GET refnum QUERY_NICK) returns the current target
 +  * The [[send]] command sends a message to your query instead of the current channel (if you have both)
 +  * The [[say]] command sends a message to your query if you don't have a current channel.
 +  * The [[me]] command sends a [[ctcp action]] to your query instead of the current channel (if you have both)
 +  * Naked text you type at the input line is sent to your query instead of the current channel (if you have both)
 +  * [[EXEC|EXEC -OUT]] will send the output to your query instead of the current channel (if you have both)
 +
 +=====Modifying the target list:=====
 +^ Action ^ Result ^
 +| [[WINDOW QUERY]] nick | Add a target to the list and make it the current target. |
 +| [[WINDOW QUERY]] | Clear the window'​s target list.  After this, the window will not have a query nick. |
 +| [[WINDOW ADD]] nick | Add a target to the list, but do not make it the current target.|
 +| [[WINDOW REMOVE]] nick | Removes the target from the list.  If it is the current target and the list is not empty, choose another target to be the query.
 +
 +=====Important Concepts:​=====
 +"Nick lists" are per-server.  ​
 +
 +Messages to or from a nickname will not be sent to a window that is connected ​
 +to another server.  ​
 +
 +If a you assign a target to a window when it is already assigned somewhere ​
 +else, it will be removed from the existing window for you (i.e., it is moved)
 +
 +In the future, queries will be unified with channels and there will be no
 +difference between a "​current query" and "​current channel"​.
 +
  
window_targets.txt ยท Last modified: 2009/06/01 00:47 (external edit)