Fixed up Grid and Space() documentation.

2 files changed, 8 insertions, 2 deletions

diff --git a/grid.go b/grid.go
index 1cea202..78d1f2e 100644
--- a/grid.go
+++ b/grid.go
@@ -9,7 +9,9 @@ import (
 // A Grid arranges Controls in a two-dimensional grid.
 // All Controls in a Grid maintain their preferred sizes.
 // The height of each row and the width of each column is the maximum preferred height and width (respectively) of all the controls in that row or column (respectively).
+// Controls are aligned to the top left corner of each cell.
 // Unlike other UI toolkit Grids, this Grid does not (yet?) allow Controls to span multiple rows or columns.
+// TODO differnet row/column control alignment; stretchy controls or other resizing options
 type Grid struct {
 	lock					sync.Mutex
 	created				bool
diff --git a/stack.go b/stack.go
index c01e9bd..269bee4 100644
--- a/stack.go
+++ b/stack.go
@@ -164,8 +164,12 @@ func (s *Stack) preferredSize() (width int, height int, err error) {
 	return
 }
 
-// Space returns a null control intended for padding layouts with blank space where otherwise impossible (for instance, at the beginning or in the middle of a Stack).
-// In order for a Space to work, it must be marked as stretchy in its parent layout; otherwise its size is undefined.
+// Space returns a null control intended for padding layouts with blank space.
+// It appears to its owner as a control of 0x0 size.
+//
+// For a Stack, Space can be used to insert spaces in the beginning or middle of Stacks (Stacks by nature handle spaces at the end themselves). In order for this to work properly, make the Space stretchy.
+//
+// For a Grid, Space can be used to have an empty cell. (TODO stretching/sizing rules)
 func Space() Control {
 	// As above, a Stack with no controls draws nothing and reports no errors; its parent will still size it properly if made stretchy.
 	return NewStack(Horizontal)