NAME

       rpws - Implements multiple workspaces in ratpoison

SYNOPSIS

        rpws init n [-k] [-a]  - setup rpws with n workspaces.
                                   -a sets up command aliases;
                                   -k sets up key bindings and aliases.
        rpws dump <fname>      - dumps the current layout to <fname>
        rpws restore <fname>   - restores rpws workspaces from <fname>
        rpws current           - print the current workspace
        rpws help              - this documentation
        rpws n                 - switch to this workspace

DESCRIPTION

        B<rpws> implements multiple workspaces in ratpoison by making calls
        to fdump, freestore.  It was adapted from rpws which comes with
        ratpoison in the contrib directory.

USAGE

       Add the following line in ~/.ratpoisonrc

            exec /path/to/rpws init 6 -k

       This creates 6 aliases rpws1, rpws2, etc. It also binds the keys M-F1, M-F2, etc to each
       rpwsN alias. Moreover, rpwsn (Next) and rpwsp (Prev) are created, and C-M-{Right,Left} are
       bound to rpws{n,p}. Aliases rpwsm1, rpwsm2, etc. and rpwsm{n,p} are used to move the
       focused window to another workspace.

       Full list of keybindings created are:

           M-F$i           Goto workspace $i
           C-M-Right       Goto Next workspace
           C-M-Left        Goto Prev workspace
           C-M-S-F$i       Move window to workspace $i
           C-M-greater     Move current window to next workspace
           C-M-less        Move current window to prev workspace

FILES

        rpws requires use of a lockfile.  It defaults to using
       /tmp/rpws.<UID>.lock but this can be changed by setting the
       environment variable RPWS_LOCKFILE to your desired lockfile.

AUTHOR

        Mike O'Connor <stew@vireo.org>

COPYRIGHT

        Copyright (c) 2005 Mike O'Connor
        All rights reserved.

        This program is free software; you can redistribute it and/or
        modify it under the terms of the GNU General Public License
        as published by the Free Software Foundation; either version 2
        of the License, or (at your option) any later version.

        This program is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        GNU General Public License for more details.