# $EPIC: create,v 1.4 2005/03/08 05:53:31 jnelson Exp $
Synopsis:
   window create

Description:
   This command creates a new physical screen.  Depending on the programs
   you are using, this physical screen may take one of two manifestations.
   A physical screen is a container of one or more windows plus an input
   line.  When you create a new physical screen, it also creates a new 
   window and puts that window in the new screen.

   The first type of physical screen supported is under GNU Screen.  The
   'screen' program is a popular way to multiplex multiple programs into
   one login session, and have those programs continue running when you
   log out.  If you run EPIC under screen, then WINDOW CREATE will
   create a new screen you can switch to (via ^A-<number>).

   The second type of physical screen supported is under X Window.  If you
   are not sure if you are running X Window, but you are running with a
   graphical desktop called "KDE" or "GNOME", you are using X.  When you 
   run EPIC under X, then WINDOW CREATE will create a new terminal
   you can place on your desktop.

   If you are running under both X and Screen at the same time (as you may
   be doing if you are using KDE on your desktop and you're using ssh to 
   log into a remote host where you are running screen to run epic all the
   time), and you're using a version of epic before EPIC4-1.1.14, you should
   try to unset the STY or DISPLAY environment variables before you start
   epic or it may not be able to function properly.

   Since EPIC4-1.1.14 there is a new /SET, SET WSERV_TYPE which
   you can set to either the value SCREEN or XTERM, which controls
   which type of screen you want to create.

   If you try to create a new XTERM screen, your epic client needs to be
   able to connect to the X server given in your DISPLAY environment variable,
   or WINDOW CREATE will fail.

   ircII-EPIC up through epic4-1.1.2 required that all screens be exactly the
   same geometry (height and width).  This was pretty unfriendly, and since
   epic4-1.1.3 has been able to support a different geometry on each screen.

   This command might not be available if the person who compiled ircii-EPIC
   #undef'ined WINDOW_CREATE in config.h.  It is #define'd by default so this
   would have been a conscious decision by that person.

   Use of multiple screens before epic4-1.1.3 was sometimes unreliable and
   sometimes frustrating, so just be forewarned.

See Also:
   window(4) delete, new

History:
   This operation first appeared in ircII-2.2
