[sawfish] grow-pack doc upgrade.
- From: Christopher Bratusek <chrisb src gnome org>
- To: svn-commits-list gnome org
- Cc:
- Subject: [sawfish] grow-pack doc upgrade.
- Date: Sat, 24 Oct 2009 07:17:13 +0000 (UTC)
commit 9ce321f4923f41169b1b6b64ca701e0636fcf1cf
Author: Teika kazura <teika lavabit com>
Date: Mon Oct 19 18:38:48 2009 +0900
grow-pack doc upgrade.
ChangeLog | 3 +++
lisp/sawfish/wm/commands/grow-pack.jl | 10 ++++++++--
man/sawfish.texi | 25 +++++++++++++++++--------
3 files changed, 28 insertions(+), 10 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index d477cec..c303d2f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -4,6 +4,9 @@
* man/news.texi
* man/sawfish.texi: Completed doc updates for applications menu.
+ * lisp/sawfish/wm/commands/grow-pack.jl
+ * man/sawfish.texi: grow-pack doc upgrade.
+
2009-10-17 Christopher Bratusek <zanghar freenet de>
* lisp/sawfish/wm/ext/apps-menu.jl: removed dupped Development Category from Developmentmenu
added Editors Category to Developmentmenu
diff --git a/lisp/sawfish/wm/commands/grow-pack.jl b/lisp/sawfish/wm/commands/grow-pack.jl
index 5bca887..879fc61 100644
--- a/lisp/sawfish/wm/commands/grow-pack.jl
+++ b/lisp/sawfish/wm/commands/grow-pack.jl
@@ -61,7 +61,12 @@
:group (move gpsy))
(defcustom pack-warp-pointer 'maybe
- "Whether and how to move the pointer."
+ "Whether and how to move the pointer when packing windows.
+`maybe' means that the pointer is moved along with the window, if the
+pointer was within the window area before packing. `always' warps the
+pointer to the center of the window if it isn't already in the
+window, then does like `maybe'. `never' means not to warp the
+pointer."
:type (choice always maybe never)
:group (move gpsy))
@@ -71,7 +76,8 @@
:group (move gpsy))
(defcustom grow-pack-bump-other-depth 'always
- "Whether to bump into windows on a different depth."
+ "Whether to bump into windows on a different depth. When 'maybe,
+Only `avoided' windows are bumped."
:type (choice always maybe never)
:group (move gpsy))
diff --git a/man/sawfish.texi b/man/sawfish.texi
index 6c00f99..878a245 100644
--- a/man/sawfish.texi
+++ b/man/sawfish.texi
@@ -1767,8 +1767,9 @@ Halve the size of @var{window}
@end deffn
Sawfish supports increasing a windows size until it bumps into another
-window, this is called @code{grow}. @code{shrink} achieves the opposite,
-it decreases a windows size, until it does no longer overlap any other window.
+window. This is called ``grow''. ``Shrink'' achieves the opposite,
+i.e. it decreases a windows size, until it does no longer overlap any
+other window, or more precisely, until it overlaps with one less window.
@deffn Command grow-window-up window #!optional arg
Grows @var{window} upwards until it "bumps into" another window.
@@ -1813,9 +1814,9 @@ Shrinks @var{window} by moving the left edge to the right until it
intersects with one window less than before.
@end deffn
-in addition to @code{grow} and @code{shrink} sawfish also has @code{pack} and @code{yank},
-the difference is that while @code{grow} and @code{shrink} resize the window,
- code{pack} and @code{yank} move it.
+Moving counterparts, instead of resizing of ``grow'' and ``shrink'',
+are ``pack'' and ``yank''. So, ``pack'' moves until the window bumps
+into another, and ``yank'' moves until the overlap reduces.
@deffn Command pack-window-up window #! optional arg
Moves @var{window} upwards until it "bumps into" another window.
@@ -1868,8 +1869,14 @@ The default value is @code{t}.
@end defvar
@defvar pack-warp-pointer
-Whether and how to move the pointer, either @code{allways} @code{maybe}
-or @code{never}. The default value is @code{maybe}.
+Whether and how to move the pointer, either @code{always} @code{maybe}
+or @code{never}. The default value is @code{maybe}
+
+ code{maybe} means that the pointer is moved along with the window, if
+the pointer was within the window area before packing. @code{always}
+warps the pointer to the center of the window if it isn't already in
+the window, then does like @code{maybe}. @code{never} means not to
+warp the pointer.
@end defvar
@defvar grow-pack-bump-obscured
@@ -1878,8 +1885,10 @@ The default value is @code{nil}.
@end defvar
@defvar grow-pack-bump-other-depth
-Whether to bump into windows on a different depth, either @code{allways}
+Whether to bump into windows on a different depth, either @code{always}
@code{maybe} or @code{never}. The default value is @code{always}.
+
+ code{maybe} means only @code{avoided} windows (@pxref{Avoided Windows}).
@end defvar
@defvar grow-pack-bump-ignored
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]