Implementation of TIP#146,

"Add Overall Anchoring to the Grid Geometry Manager",
adding [grid anchor] subcommand.

1 files changed, 14 insertions, 3 deletions

diff --git a/doc/grid.n b/doc/grid.n
index 07c1ddd..b2790e9 100644
--- a/doc/grid.n
+++ b/doc/grid.n
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: grid.n,v 1.6 2003/09/18 18:22:22 pspjuth Exp $
+'\" RCS: @(#) $Id: grid.n,v 1.7 2004/01/09 22:23:26 pspjuth Exp $
 '\" 
 .so man.macros
 .TH grid n 8.5 Tk "Tk Built-In Commands"
@@ -31,6 +31,13 @@ starting with \fB.\fP) or one of the characters \fBx\fP or \fB^\fP
 (see the ``RELATIVE PLACEMENT'' section below), then the command is
 processed in the same way as \fBgrid configure\fR.
 .TP
+.VS 8.5
+\fBgrid anchor \fImaster\fR ?\fIanchor\fR?
+The anchor value controls how to place the grid within the master
+when no row/column has any weight.  See ``THE GRID ALGORITHM'' below
+for further details.  The default \fIanchor\fR is \fInw\fR.
+.VE
+.TP
 \fBgrid bbox \fImaster\fR ?\fIcolumn row\fR? ?\fIcolumn2 row2\fR?
 With no arguments, 
 the bounding box (in pixels) of the grid is returned.
@@ -333,15 +340,19 @@ minimum size.  For example, if all rows or columns in a group have the
 same weight, then each row or column will have the same size as the
 largest row or column in the group.
 .PP
+
+.VS 8.5
 For masters whose size is larger than the requested layout, the additional
 space is apportioned according to the row and column weights.  If all of
-the weights are zero, the layout is centered within its master.
+the weights are zero, the layout is placed within its master according to
+the \fIanchor\fR value.
 For masters whose size is smaller than the requested layout, space is taken
 away from columns and rows according to their weights.  However, once a 
 column or row shrinks to its minsize, its weight is taken to be zero.
 If more space needs to be removed from a layout than would be permitted, as
 when all the rows or columns are at there minimum sizes, the layout is
-clipped on the bottom and right.
+placed and clipped according to the \fIanchor\fR value.
+.VE
 .SH "GEOMETRY PROPAGATION"
 .PP
 The grid geometry manager normally computes how large a master must be to