Re: [RP] undo and redo

[Sven . Hartrumpf]

On 26 Apr 2005, address@hidden wrote:

> On Mon, Apr 25, 2005 at 03:01:14PM +0200, address@hidden wrote:
> > I found the very powerful command "undo".
> > Why is not it documented in ratpoison.texi?
...
> Because it was a proof-of-concept patch that got committed unexpectedly,

I see.

> If you want something to do, post a patch to texi that adds the
> documentation.

Attached to this mail. With some typo corrections.

> > And: now that we have "undo",
> > are there any plans for "redo"?
> 
> Nope.
> 
> Undo was intended to solve one problem: After hitting :only, you had to
> painstakingly restore the frameset (or remember to fdump beforehand).
> 
> Feel free to do it yourself -- study the src/actions.c file.

Should the patch use lists (as the code suggests) or would an array
be acceptable?

Ciao
Sven

--- ratpoison.texi      2005-04-18 08:28:26.000000000 +0200
+++ ratpoison.texi.new  2005-04-25 21:23:00.000000000 +0200
@@ -137,12 +137,12 @@
 @chapter Concepts
 
 ratpoison uses the concept of @dfn{panes} to place and size
-windows. Instead of allowing windows to have arbitary shapes at
-arbitary locations on the screen, the display is divided into panes,
+windows. Instead of allowing windows to have arbitrary shapes at
+arbitrary locations on the screen, the display is divided into panes,
 the same way a physical window might contain several pieces of glass
-seperated by wood. In ratpoison, the panes are called @dfn{frames},
-and windows are placed in them, maximised. ratpoison starts with one
-frame, which can be split into an arbitary number of smaller
+separated by wood. In ratpoison, the panes are called @dfn{frames},
+and windows are placed in them, maximized. ratpoison starts with one
+frame, which can be split into an arbitrary number of smaller
 ones. Each frame can be split in half either horizontally or
 vertically. You can move among them, making different ones the
 current. For more information, see @ref{Splitting Frames}.
@@ -248,7 +248,7 @@
 Instead of a message bar, you will get a list of the windows printed
 to stdout. This allows you to write more advanced scripts than simple
 keyboard macros. This is where @var{fmt} comes into play. If
address@hidden is given an arg it treats it as the format string as
address@hidden is given an argument it treats it as the format string as
 described in @command{defwinfmt}.
 @end deffn
 
@@ -467,7 +467,7 @@
 Some programs will attempt to steal the focus without the users
 permission. Not only is this a sign of a lame programmers attempt to fix
 a window manager problem in the wrong place, it's just plain rude. By
-default ratpoison will honour these rudeness requests, but it doesn't
+default ratpoison will honor these rudeness requests, but it doesn't
 have to. Use the @command{rudeness} command to deal with such programs.
 
 @deffn Command rudeness @var{n}
@@ -481,7 +481,7 @@
 ratpoison. ratpoison then decides whether to grant the request and
 display the window or ignore it. A client program can also request
 that one of its windows be raised. You can customize ratpoison to
-either honour these requests (the default operation) or ignore them.
+either Honor these requests (the default operation) or ignore them.
 
 @var{n} is a number from 0 to 15. Each of the four bits determine
 which requests ratpoison grants.
@@ -516,10 +516,10 @@
 coupled with saving and restoring frames configurations is what most
 people would call @dfn{virtual desktops} or @dfn{workspaces}. 
 
-While ratpoison doesn't explicity provide support for such things, it
+While ratpoison doesn't explicitly provide support for such things, it
 does allow you to write scripts to this end. Such a script exists in
 @file{contrib/} called @file{rpws}. Consult that file for details on
-seting up workspaces inside ratpoison.
+setting up workspaces inside ratpoison.
 
 Groups are more general purpose than workspaces. windows from one
 group can be visible along with windows from another group. If you
@@ -770,7 +770,7 @@
 save and restore frame layouts with the press of a key.
 
 @deffn Command fdump
-dump the current frame layout as text. When used non-interactively
+Dump the current frame layout as text. When used non-interactively
 (from the command-line), ratpoison will print the frame layout. When
 used interactively, nothing happens.
 @end deffn
@@ -781,6 +781,16 @@
 calling @code{fdump}.
 @end deffn
 
+A special case of restoring a frame configuration is to undo
+the previous change of frame layout.
+
address@hidden Command undo
+Undo the last change of frame layout. This is especially helpful
+after a @command{only} command. One can step at most maxundos
+steps back in frame layout history.
address@hidden deffn
+
+
 @node Frame Numbering,  , Saving and Restoring Frame Sets, Frames
 @section Frame Numbering
 
@@ -801,7 +811,7 @@
 @node Multiple Monitors, Keystrokes, Frames, Top
 @chapter Multiple Monitors
 When you've finally accumulated enough computer junk, you'll find
-youself attaching a second monitor to your computer. ratpoison has
+yourself attaching a second monitor to your computer. ratpoison has
 functionality to help you get around your new and improved desktop
 space.
 
@@ -845,7 +855,7 @@
 
 ratpoison uses the Emacs style key notation. A combination of
 modifiers and one non-modifier key combine to invoke an action. The
-syntax is one or more modifiers seperated with dashes followed by a
+syntax is one or more modifiers separated with dashes followed by a
 dash and the non-modifier key name. For instance, holding down
 control, shift, and super then pressing the spacebar would be
 described as:
@@ -887,7 +897,7 @@
 map can be accessed simply by pressing the key. This is where the prefix
 key resides.
 
-The following example adds a @kbd{C-x b} keybinding to switch windows,
+The following example adds a @kbd{C-x b} key binding to switch windows,
 much like @kbd{C-x b} in Emacs. See the functions below for full
 descriptions.
 
@@ -1104,7 +1114,7 @@
 
 Each hook contains a list of commands to be executed when the
 appropriate event occurs in ratpoison. For example, if you want to warp
-the rat to corner of the screen everytime you press a top level bound
+the rat to corner of the screen every time you press a top level bound
 key, you could add this to you .ratpoisonrc file:
 
 @example
@@ -1234,7 +1244,7 @@
 function so they can build a replacement or patch an existing
 alternative's missing functionality.
 
-According to independant studies, @command{tmpwm} has been used almost
+According to independent studies, @command{tmpwm} has been used almost
 exclusively to verify it's correct operation -- like a vintage sports
 care: always kept in prime condition and never used. 
 
@@ -1392,23 +1402,24 @@
 Here is a list of variables that can be set:
 
 @itemize @bullet
address@hidden resizeunit
address@hidden wingravity
address@hidden transgravity
address@hidden maxsizegravity
address@hidden barborder
 @item bargravity
address@hidden font
address@hidden padding
address@hidden barpadding
address@hidden bgcolor
 @item border
address@hidden barborder
address@hidden fgcolor
address@hidden font
 @item inputwidth
address@hidden maxsizegravity
address@hidden maxundos
address@hidden padding
address@hidden resizeunit
address@hidden transgravity
 @item waitcursor
 @item winfmt
address@hidden winname
address@hidden fgcolor
address@hidden bgcolor
address@hidden barpadding
address@hidden wingravity
 @item winliststyle
address@hidden winname
 @end itemize
 @end deffn
 
@@ -1441,7 +1452,7 @@
 @end deffn
 
 @deffn Command verbexec @var{command}
-Verbosely exec the shell command @var{command}. Raptoison displays a
+Verbosely exec the shell command @var{command}. Ratpoison displays a
 message saying command was executed.
 @end deffn
 
@@ -1529,7 +1540,7 @@
 complete the text up to the point or if there are several possible
 completions, cycle through them. This only works in certain
 contexts. Tab completion will complete a shell command, a window name,
-a group name, and colon commands in their apropriate context
+a group name, and colon commands in their appropriate context
 (i.e. when being asked for a window name).
 
 @item S-iso-lefttab
@@ -1588,7 +1599,7 @@
 
 @item -i, --interactive
 Force ratpoison to execute commands in interactive mode. This is used
-in conjuction with the @option{-c} option.
+in conjunction with the @option{-c} option.
 
 @item -f, --file
 Specify an alternate configuration file. @xref{Startup file}.