Index: trunk/nv/position.hh
===================================================================
--- trunk/nv/position.hh	(revision 114)
+++ trunk/nv/position.hh	(revision 115)
@@ -161,7 +161,35 @@
 		 */
 		bool is_valid() const {	return x2 >= x1 && y2 >= y1; }
+
+		/**
+		 *Enlarges the rectangle by a given amount.  Each side is adjusted by the given amount, e.g. expanding by 1 increases the width and height by 2 each.
+		 *
+		 *@param value The amount to adjust each sides by.
+		 */
 		void expand( value_type value ) { position p(value,value); ul -= p; lr += p; }
+
+		/**
+		 *Reduces the rectangle by a given amount.  Each side is adjusted by the given amount, e.g. shrinking by 1 decreases the width and height by 2 each.
+		 *
+		 *@param value The amount to adjust each side by.
+		 */
 		void shrink( value_type value ) { position p(value,value); ul += p; lr -= p; }
+
+		/**
+		 *Gets a rectangle that is an expanded version of this rectangle.
+		 *
+		 *@param value The amount to adjust each side by.
+		 *@returns An expanded rectangle.
+		 *@see expand
+		 */
 		rectangle expanded( int value ) { position p(value,value); return rectangle(ul-p, lr+p); }
+
+		/**
+		 *Gets a rectangle that is a shrunk version of this rectangle.
+		 *
+		 *@param value The amount to adjust each side by.
+		 *@returns A shrunk rectangle.
+		 *@see shrink
+		 */
 		rectangle shrinked( int value ) { position p(value,value); return rectangle(ul+p, lr-p); }