From 7c61cf886771708ae937a1447bdd09a5fd26806d Mon Sep 17 00:00:00 2001 From: sabetts Date: Fri, 21 Dec 2001 12:56:53 +0000 Subject: updates to reflect the state of the code --- doc/ratpoison.texi | 94 +++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 65 insertions(+), 29 deletions(-) (limited to 'doc') diff --git a/doc/ratpoison.texi b/doc/ratpoison.texi index b211a05..5c6404c 100644 --- a/doc/ratpoison.texi +++ b/doc/ratpoison.texi @@ -86,8 +86,8 @@ This document explains how to use ratpoison. * Splitting Frames:: When you want to see more than one window * Keystrokes:: Key commands and functionality * Commands:: ratpoison commands -* Command Line Arguments:: ratpoison command-line actions * Input:: Typing text into ratpoison +* Command Line Arguments:: ratpoison command-line actions * Startup file:: They threatened me...with violence! @@ -328,7 +328,7 @@ Indicate which frame is the current frame. @end table -@node Commands, Command Line Arguments, Keystrokes, Top +@node Commands, Input, Keystrokes, Top @chapter ratpoison commands ratpoison can be controlled with commands (so called colon-commands). @@ -373,37 +373,64 @@ Set the message bar location. @var{n} is a value between 0 and 3. 0 is the top left and the values move clockwise around the screen to the bottom left which is 3. +When called non-interactively with no arguments, the current setting is +returned. + @item defbarpadding @var{x} @var{y} Set the horizontal and vertical padding inside the bar. +When called non-interactively with no arguments, the current setting is +returned. + @item msgwait @var{n} Set the bar's timeout in seconds. +When called non-interactively with no arguments, the current setting is +returned. + @item defborder @var{n} Set the border width for all windows. +When called non-interactively with no arguments, the current setting is +returned. + @item deffont @var{font} Set the font. @var{font} is a font string like @samp{9x15bold}. @item definputwidth @var{n} Set the width of the input window. +When called non-interactively with no arguments, the current setting is +returned. + @item defmaxsizegravity @var{g} Set the default alignment for windows with maxsize hints. See the @command{gravity} command. +When called non-interactively with no arguments, the current setting is +returned. + @item defpadding @var{left} @var{top} @var{right} @var{bottom} Set the padding around the edge of the screen. +When called non-interactively with no arguments, the current setting is +returned. + @item deftransgravity @var{g} Set the default alignment for transient windows. See the @command{gravity} command. +When called non-interactively with no arguments, the current setting is +returned. + @item defwaitcursor @var{n} Set whether the rat cursor should change into a square when waiting for a key. A non-zero number means change the cursor. Zero means don't change the cursor. +When called non-interactively with no arguments, the current setting is +returned. + @item defwinfmt @var{fmt} Set the default window format for the @command{windows} command. By default it is @samp{N-W}. The following is a list of valid format @@ -427,6 +454,9 @@ A unique number based on when the window was last accessed. The higher the number, the more recently it was accessed. @end table +When called non-interactively with no arguments, the current setting is +returned. + @item defwinname @var{name} There are three resources ratpoison can get a window's name from: the WMNAME hint, the res_name from the WMCLASS hint, or the res_class from @@ -434,10 +464,16 @@ the WMCLASS hint. @var{name} can be @samp{title} which is what most window managers put in the title bar, @samp{name} which is the res_name, or @samp{class} which is the res_class. +When called non-interactively with no arguments, the current setting is +returned. + @item defwingravity @var{g} Set the default gravity for normal windows. See the @command{gravity} command. +When called non-interactively with no arguments, the current setting is +returned. + @item deffgcolor @var{color} Set the foreground color for all text ratpoison displays. @var{color} is any valid X11 color. @@ -652,7 +688,26 @@ described in @command{defwinfmt}. @end table -@node Command Line Arguments, Input, Commands, Top +@node Input, Command Line Arguments, Commands, Top +@chapter Input +At various times ratpoison will prompt you for input. Currently only +very basic text editing commands exist. + +@table @key +@item Backspace +Deletes one letter preceding the cursor. + +@item C-p +Cycle backwards through the history. + +@item C-n +Cycle forwards through the history. +@end table + +All input is stored in the same history list. By default ratpoison has +a history length of 50 entries. + +@node Command Line Arguments, Startup file, Input, Top @chapter Command Line Arguments ratpoison supports command line arguments to request various actions when invoking ratpoison. @@ -669,35 +724,16 @@ Send ratpoison a colon-command. This allows you to control ratpoison from the command-line. with the @option{-c} option you can script ratpoison using any programming language that can spawn a process. Some commands behave differently when invoked this -way. Currently the only command that behaves differently is the -@code{windows} command. Instead of displaying the window list in a -message window, it is printed to stdout. The output can then be -captured and used in the ratpoison script. For instance, this could be -used to check whether a program is running and if it is switch to its -window otherwise launch it. +way. Currently the only commands that behaves differently are the +@code{windows} command and some def* commands. Instead of displaying +the window list in a message window, it is printed to stdout. The +output can then be captured and used in the ratpoison script. For +instance, this could be used to check whether a program is running and +if it is switch to its window otherwise launch it. @end table -@node Input, Startup file, Command Line Arguments, Top -@chapter Input -At various times ratpoison will prompt you for input. Currently only -very basic text editing commands exist. - -@table @key -@item Backspace -Deletes one letter preceding the cursor. - -@item C-p -Cycle backwards through the history. - -@item C-n -Cycle forwards through the history. -@end table - -All input is stored in the same history list. By default ratpoison has -a history length of 50 entries. - -@node Startup file, , Input, Top +@node Startup file, , Command Line Arguments, Top @chapter Startup file Now you've probably read the web page, and you've no doubt dug up some -- cgit v1.2.3