Index: doc/ratpoison.1 =================================================================== RCS file: /cvsroot/ratpoison/ratpoison/doc/ratpoison.1,v retrieving revision 1.22 diff -u -r1.22 ratpoison.1 --- doc/ratpoison.1 18 May 2006 02:43:04 -0000 1.22 +++ doc/ratpoison.1 17 Aug 2006 13:40:03 -0000 @@ -1,4 +1,4 @@ -.TH RATPOISON 1 2005-01-28 +.TH RATPOISON 1 2006-08-17 \# This man page 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, or (at your option) @@ -617,25 +617,47 @@ of \fBwinliststyle\fP in the format set by \fBset winfmt\fP. The following substitutions happen in format: .br +%a by the application name (resource name), +.br +%c by the resource class, +.br +%f by the frame number, +.br +%g by the gravity of the window, +.br +%h by the height of the window, +.br +%H by the unit to resize the window vertically (height_inc) +.br +%i by the X Window ID, +.br +%l by the last access number, +.br %n by the window number, .br %s by window status (\fB*\fP is active window, \fB+\fP would be chosen by \fBother\fP, \fB\-\fP otherwise) .br -%t by the window name (see \fBset winname\fP), +%S by the screen number .br -%a by the application name, +%t by the window name (see \fBset winname\fP), .br -%c by the resource class, +%T by the string \fBTransient\fP, if it is a transient window .br -%i by the X Window ID, +%w by the width of the window .br -%l by the last access number, +%W by the unit to resize the window horizontally (width_inc) .br -%f by the frame number and +.%x by the xine screen number +and .br %% by a single % +Additionally there can be a positive decimal integer number between the +percent sign and the format string to specify the length this value +should be truncated to if longer. +(For example: \fB%20t\fP) + In non\-interactive mode, output the list of windows in the current group line by line. The format string can be overwritten by the optional parameter \fIformat\fP. Index: doc/ratpoison.texi =================================================================== RCS file: /cvsroot/ratpoison/ratpoison/doc/ratpoison.texi,v retrieving revision 1.116 diff -u -r1.116 ratpoison.texi --- doc/ratpoison.texi 11 Jun 2006 17:02:10 -0000 1.116 +++ doc/ratpoison.texi 17 Aug 2006 13:40:03 -0000 @@ -402,6 +402,9 @@ the window's xinerama screen @end table +Additionally there can be a number between the percent sign and the format +character, denoting a maximum length this value is to truncate to, e.g. @samp{%n%s%20t}. + When called with no arguments, the current setting is returned. @end deffn