[RP] doc patches, new section

[Mike Meyer]

I found the interactions of frames and windows a bit confusing at
first, as it's not documented anywhere. I wrote up my description of
how I think they work to ask if that was right. Since that might be
useful information, I went ahead and added it to ratpoison.texi. I'd
appreciate it if someone would let me know if my description is 1)
correct and 2) reflects the design intent of ratpoison.

N.B. - this patch is independent of the earlier patch.

        Thanx,
        <mike
--
Mike Meyer <address@hidden>                     http://www.mired.org/home/mwm/
Q: How do you make the gods laugh?              A: Tell them your plans.

--- ratpoison.texi.orig Fri Oct  5 04:41:30 2001
+++ ratpoison.texi      Fri Oct  5 06:13:16 2001
@@ -81,6 +81,7 @@
 @menu
 * About::                       What is ratpoison?
 * Contacting::                  How do I contact the ratpoison developers?
+* Concepts::                   What ratpoison manipulates
 * General Use::                 How does this thing work??
 * Splitting The Screen::        When you want to see more than one window
 * Keystrokes::                  Key commands and functionality
@@ -106,7 +107,7 @@
 
 ratpoison was written by Shawn Betts (@email{sabetts@@users.sourceforge.net}).
 
address@hidden Contacting, General Use, About, Top
address@hidden Contacting, Concepts, About, Top
 @chapter Contacting
 ratpoison is hosted on @url{sourceforge.net}. To see the latest
 developments in ratpoison go to
@@ -119,7 +120,34 @@
 
 There is a #ratpoison irc channel on irc.openprojects.net.
 
address@hidden General Use, Splitting The Screen, Contacting, Top
address@hidden Concepts, General Use, Contacting, Top
address@hidden Concepts
+
+ratpoison is a @dfn{paned} window manager. Instead of allowing windows
+to have arbitrary shapes at arbitrary locations on the screen, the
+screen is divided into panes like a real window. The panes are called
address@hidden, and windows are placed in frames and sized to fill the
+frame. ratpoison starts with one frame. It can be split into more
+frames and you can move among the frames, making different frames
+current. For more information, see @ref{Splitting The Screen}.
+
+Each frame has at most one window associated with it, which is visible
+in that frame. If you select a window that is associated with a frame,
+that frame will become current. If you select a window that is not
+associated with a frame, that window will be opened in the current
+frame and resized to fit that frame.
+
+If the window associated with a frame does not fill the frame
+completely, the various gravity commands control how it is placed. If
+no window was open in that frame before the current window was opened,
+the X root will be visible behind it. If a window was open in that
+frame before the current window was opened, that window will be
+visible behind the current window, and can be interacted with with the
+mouse but not the keyboard. However, it is @emph{not} associated with
+that frame, and selecting it in another frame will cause it to open in
+that frame.
+
address@hidden General Use, Splitting The Screen, Concepts, Top
 @chapter General Use
 
 When ratpoison starts you should see an empty X server. To open an x