summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorsabetts <sabetts>2006-03-15 05:43:38 +0000
committersabetts <sabetts>2006-03-15 05:43:38 +0000
commit9c9e71d4e681112668240c6c0c9715b8f77ed673 (patch)
tree0d818469f129c7f7aecf933c93599f77df00e651 /doc
parent0d47aa583ef5ce0178de264f46fcb028c8592e53 (diff)
downloadratpoison-9c9e71d4e681112668240c6c0c9715b8f77ed673.zip
(init_user_commands): add optional argument to "info"
(cmd_info): handle optional argument * src/format.c: new file * src/format.h: new file * Makefile.am (ratpoison_SOURCES): add format.c and format.h * src/actions.c (set_infofmt): new function (wingravity_to_string): char * instead of static char * because needed in format.c (cmd_info): use format_string * src/actions.h (wingravity_to_string): add prototype * src/data.h (info_fmt): new variable * src/main.c (init_defaults): set a value for defaults.info_fmt * src/ratpoison.h: include format.h * src/windows.c (get_window_list): use format_string (isdigit): remove function as the formatting is now done in format.c (concat_width): likewise (format_window_name): likewise
Diffstat (limited to 'doc')
-rw-r--r--doc/ratpoison.texi48
1 files changed, 36 insertions, 12 deletions
diff --git a/doc/ratpoison.texi b/doc/ratpoison.texi
index 920d654..8debef0 100644
--- a/doc/ratpoison.texi
+++ b/doc/ratpoison.texi
@@ -250,7 +250,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
@command{windows} is given an argument it treats it as the format string as
-described in @command{defwinfmt}.
+described in @command{set winfmt}.
@end deffn
@deffn Command title @var{title}
@@ -283,8 +283,11 @@ misbehaving window this command should do the trick. Also available as
@end deffn
-@deffn Command info
-Display information about the current window.
+@deffn Command info @var{fmt}
+Display information about the current window. At optional @var{fmt}
+argument can be passed to override the default format. @command{info}
+accepts the same format options as @command{windows}.
+
@end deffn
@deffn Command gravity @var{g}
@@ -307,6 +310,11 @@ This deletes the current window. You can access it with the @kbd{C-t k}
keystroke.
@end deffn
+@deffn Command {set infofmt} @var{fmt}
+Set the default window format for the @command{info} command. See
+@command{set winfmt} for accepted format characters.
+@end deffn
+
@deffn Command {set winname} @var{name}
@c @deffnx Command defwinname @var{name}
There are three resources ratpoison can get a window's name from: the
@@ -339,24 +347,40 @@ default it is @samp{%n%s%t}. The following is a list of valid format
characters:
@table @samp
-@item %n
-The window number
-@item %s
-Window status (current window, last window, etc)
-@item %t
-Window Name
@item %a
Application Name
@item %c
Resource Class
+@item %f
+The frame number the window is displayed in or a space if it is not in
+a frame.
+@item %g
+The window's gravity setting
+@item %h
+The window's height
+@item %H
+The window's height increment hint.
@item %i
X11 Window ID
@item %l
A unique number based on when the window was last accessed. The higher
the number, the more recently it was accessed.
-@item %f
-The frame number the window is displayed in or a space if it is not in
-a frame.
+@item %n
+The window number
+@item %s
+Window status (current window, last window, etc)
+@item %S
+The window's screen
+@item %t
+Window Name
+@item %T
+Whether the window is a transient or not.
+@item %w
+The window's width
+@item %W
+The window's width increment hint
+@item %x
+the window's xinerama screen
@end table
When called with no arguments, the current setting is