Create two new sections: "Xrandr support" and "Manipulating Screens".
Also s/monitor/screen/ to improve readability.
---
Hi,
Here's a patch to update documentation on xrandr changes.
Thanks,
Mathieu
doc/ratpoison.texi | 63 ++++++++++++++++++++++++++++++++++++++++++++++--------
1 file changed, 54 insertions(+), 9 deletions(-)
diff --git a/doc/ratpoison.texi b/doc/ratpoison.texi
index 1fa79c3..a716fd2 100644
--- a/doc/ratpoison.texi
+++ b/doc/ratpoison.texi
@@ -73,7 +73,7 @@ This document explains how to use ratpoison @value{VERSION}.
* Windows:: Navigating The Windows
* Groups:: Grouping Windows Together
* Frames:: Dividing The Screen
-* Multiple Monitors:: What To Do With All Your Computer Junk
+* Multiple Screens:: What To Do With All Your Computer Junk
* Keystrokes:: Key Commands And Functionality
* Hooks:: Attaching Scripts To Ratpoison Events
* The Status Bar:: Ratpoison's Input/Output Area
@@ -104,6 +104,11 @@ Frames
* Frame Numbering::
* Dedicated Frames::
+Mutiple Screens
+
+* Xrandr support::
+* Manipulating Screens::
+
Keystrokes
* Key Maps::
@@ -835,7 +840,7 @@ save and restore frame layouts with the press of a key.
Dump the current frame layout as text.
Without an argument the current screen's frames are dumped. With an
-argument the @var{screen-num}th screen is dumped. @xref{Multiple Monitors}.
+argument the @var{screen-num}th screen is dumped. @xref{Multiple Screens}.
@end deffn
@deffn Command frestore @var{frames}
@@ -885,15 +890,55 @@ If @var{arg} is not supplied, toggle the dedicated state
of the
current frame.
@end deffn
-@node Multiple Monitors
-@chapter Multiple Monitors
+@node Multiple Screens
+@chapter Multiple Screens
+
When you've finally accumulated enough computer junk, you'll find
-yourself attaching a second monitor to your computer. ratpoison has
+yourself attaching a second screen to your computer. ratpoison has
functionality to help you get around your new and improved desktop
space.
-The X Windowing System assigns each monitor a screen number. To switch
-to another screen use the commands @command{nextscreen} and
+@menu
+* Xrandr support::
+* Manipulating Screens::
+@end menu
+
+@node Xrandr support
+@section Xrandr support
+
+Since 1.4.8 version, ratpoison has dropped deprecated Xinerama support
+for Xrandr.
+
+Please note that ratpoison only supports Xrandr 1.3 or later.
+
+This switch means that ratpoison uses Xrandr to detect initial
+screen configuration when started.
+
+Ratpoison is now also able to detect dynamically :
+
+@itemize @bullet
+@item
+Screen additions and removals.
+@item
+Screen rotations.
+@item
+Screen resizings.
+@end itemize
+
+When the user runs @command{xrandr} command or any other related tool,
+to modify the Xrandr screen setup, ratpoison is notified by the
+X Windowing System.
+
+It is no longer needed to restart ratpoison for changes to be detected,
+as in previous Xinerama based releases.
+
+@node Manipulating Screens
+@section Manipulating Screens
+
+Ratpoison has commands helping users to deal with mutiple screens
+detected by Xrandr.
+
+To switch to another screen use the commands @command{nextscreen} and
@command{prevscreen}. Or, @command{sselect} to jump to a specified
screen. ratpoison will tell you which frame has focus by drawing the
current frame indicator in it.
@@ -912,12 +957,12 @@ or you can use @command{nextscreen},
@command{prevscreen}, and
@deffn Command nextscreen
This jumps you to the next X11 screen. @command{nextscreen} is
-used for dual-head displays and multiple monitor setups.
+used for dual-head displays and multiple screen setups.
@end deffn
@deffn Command prevscreen
This jumps you to the previous X11 screen. @command{prevscreen} is
-used for dual-head displays and multiple monitor setups.
+used for dual-head displays and multiple screen setups.
@end deffn
@deffn Command sselect @var{n}
--
2.12.0
_______________________________________________
Ratpoison-devel mailing list
[email protected]
https://lists.nongnu.org/mailman/listinfo/ratpoison-devel
