Table of Contents
# $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 “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 -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 |
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”.