Depending on whether or not the argument is a window or a tile, the behaviour of this method is rather different. Using window argument is intended for initial creation of windows, while using a tile argument is intended for adding windows to an already open frame object:

• window object argument If the window is part of a vertical stack, place the new window at the top of the stack. If the window is part of a horizontal stack, create a vertical stack holding the receiver and stack of the argument window. If the window is not part of a stack, create a vertical stack holding both windows.
• tile object argument Align the receiver immediately above the argument tile, giving it the same width. If the argument is part of a vertical stack, insert the receiver at the proper location in the stack. If the argument is part of a horizontal stack, create a vertical stack holding the argument and the receiver, and let this new tile object replace the argument tile in the tile hierarchy.

  To align a window nicely above another window, use:

  send(NewWindow, above, Old?tile).

  To align a window above two horizontally aligned windows, use:

  send(NewWindow, above, Old?tile?super).

  If the receiver window is not already part of the same frame as the argument window it will be made part of this frame. Thus method may be used after one or both windows have been created.

  The techniques chapter in the Users's Guide contains a section on generation window layout in a frame.

  See also

  - frame->append
  - window-frame
  - topic Window Layout
  - window->right
  - window->left
  - window->below