8.0;wp (window_pop) *DM*, revision 8.0, 84/11/07
WP (WINDOW_POP) -- Push or pop a window on the stack.
usage:  wp [window_name|group_name] [-t|-b]


FORMAT

  WP [window_name|group_name] [-T|-B]


  The WP command pops a window to the top of the stack or pushes a window to the
  bottom of the stack.  If the cursor rests in a partially obscured window,  the
  WP  command  pops the window to the top of the pile.  If the cursor rests in a
  completely visible window, WP pushes the window to the bottom of the pile.  WP
  can  also  manipulate  specific  named  windows  or  window  groups.   See the
  ARGUMENTS section below.

  By default, the WP  command  is  invoked  by  the  <POP>  key  on  low-profile
  keyboards, while the same function is provided by CTRL/P on 880 keyboards.


ARGUMENTS

  window_name
  (optional)          Push or pop the window with the specified name.  Not valid
                     if 'group_name' is specified.

                     Default if omitted:  Push or pop the window containing the
                                          cursor.

  group_name
  (optional)         Push or pop all windows with  the  specified  group.    Not
                     valid if 'window_name' is specified.

                     Default if omitted:  Push or pop the window containing the
                                          cursor.


OPTIONS

  The  following options are intended primarily for use in DM scripts, where you
  may not be able to predict the presence of other windows on the screen.

  -T                 Force a window to the top of the window stack.

  -B                 Force a window to the bottom of the window stack.


EXAMPLES

    Command: wp -t                  Pop the window containing the cursor
                                    to the top of the window stack.

    Command: wp slide -b            Push the window named 'slide' to the
                                    bottom of the stack.


RELATED TOPICS

  More information is available.  Type:

  - HELP WINDOWS
   for general information about windows.

  - HELP DM COMMANDS
   for a list of other window management commands.