# $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".