Site Tools


window_targets
no way to compare when less than two revisions

Differences

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


window_targets [2009/06/01 00:47] (current) – created - external edit 127.0.0.1
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 by 127.0.0.1