# $EPIC: window,v 1.3 2005/03/08 05:53:31 jnelson Exp $
Synopsis:
   window [<refnum>] [<command> [<arguments> ...]]

About Servers:
   Windows are portals to irc servers.  Through your windows, you send and 
   receive data from the irc servers you are connected to.  Each open server 
   has one (or more) windows "attached" to it.  This association is so strong 
   that a server is connected to when the first window is attached and a 
   server is disconnected when the last window is detached.

About Screens:
   Screens are the portal between you and your windows.  When you are typing
   text, you are actually talking to the screen, and the screen sends your 
   commands on to the current window, who then talks to its associated server.
   Windows can be visible (assigned to a screen) or hidden (not assigned to
   a screen), and this does not affect their operation.

Description:
   The WINDOW command allows you to manipulate your windows.  You can perform
   roughly 7 types of operations:

   Type 1 -- Servers
      The primary duty of every window is to act as a portal to a server, to
      hold output between you and the server.  These operations allow you to
      assign or de-assign a window's connection with servers
		DISCON		NOSERV		SERVER

   Type 2 -- Message routing
      Each server can have multiple windows, and you may want to sort the 
      output from a server and send it to various windows based on different
      criteria.  An example of this is having a separate window for each 
      channel or query.  These operations allow you to tell what window gets
      what otuput.
		ADD		CHANNEL		ECHO		LEVEL
		QUERY		REJOIN		REMOVE

   Type 3 -- Screen management
      Each window can either be visible (assigned to a screen) or hidden
      (not assigned to a screen), and can have be in any position and of 
      any size.  These operations allow you to manage the placement and 
      composition of your windows on your screens.
		BACK		BALANCE		CREATE		DELETE
		FIXED		GOTO		GROW		HIDE
		HIDE_OTHERS	KILL		KILL_ALL_HIDDEN	KILL_OTHERS
		KILLSWAP	LAST		MOVE		MOVE_TO
		NEW		NEW_HIDE	NEXT		POP
		PREVIOUS	PUSH		REFNUM		REFNUM_OR_SWAP	
		SHOW		SHOW_ALL 	SHRINK		SIZE
		SKIP		STACK		SWAP		SWAPPABLE

   Type 4 -- View management
     Each window has three "views" which control what you see in your window.
     These views are the Normal View, the Hold Mode View, and the Scrollback
     View.  All three views operate independantly of the other two, and epic
     automatically decides which view is being used.  These operations allow
     you to control the three views, and what they show.
		CLEAR		FLUSH		HOLD_INTERVAL	HOLD_MODE
		HOLD_SLIDER	SCROLL_BACKWARD	SCROLL_END	SCROLL_FORWARD
		SCROLL_START	SCROLLADJ	SCROLLBACK	SEARCH_BACK	
		SEARCH_FORWARD

   Type 5 -- Status bar
      Every window has a status bar, which shows one or two lines of meta
      information about the window and its associated server.  These
      operations allow you to manage the window's status bar
		DOUBLE		NOTIFY		NOTIFY_LEVEL	NOTIFY_NAME
		STATUS_FORMAT	STATUS_FORMAT1	STATUS_FORMAT2	STATUS_SPECIAL

   Type 6 -- Others
      These are the operations that don't fit nicely in the other categories.
		BEEP_ALWAYS	DESCRIBE	LIST		LASTLOG
		LASTLOG_LEVEL	LOG		LOGFILE		NAME
		NAME		NUMBER		PROMPT		REFRESH
		TOPLINE		TOPLINES

   Type 7 -- Deprecated
      These operations used to have some function in the past, but they will
      either be removed, or made useless in the future.
		BIND		UNBIND		SCRATCH		SCROLL

Syntax:
   The WINDOW command breaks down into a stream of operations of the form:
	WINDOW [<refnum>] <operation> [<operation-arguments>]
   The <refnum> is the target of the <operation>.  You do not have to specify
   the <refnum>, as the target of previous operation will be used.  If you do
   not provide a refnum for the first operation, the current window is used.

   If any <operation> fails, the window command fails immediately and any
   further operations are NOT performed.

History:
   The WINDOW command was already present in ircII2.1.5g.
   Many of the WINDOW operations are EPIC extensions.

