diff --git a/attachments.scad b/attachments.scad
index 108db8d..2475787 100644
--- a/attachments.scad
+++ b/attachments.scad
@@ -815,9 +815,9 @@ module hulling(a)
 // Topics: Attachments
 // See Also: color_this(), tags(), hide(), show(), diff(), intersect()
 // Description:
-//   Sets the color for children that can use the $color special variable.  For this to work
-//   you cannot have any color() modules above it in any parents, only other recolor() or color_this() modules.
-//   Note that recolor() affects its children and all their descendants.  
+//   Sets the color for children and all their descendants.  This only works with attachables and you cannot
+//   have any color() modules above it in any parents, only other recolor() or color_this() modules.
+//   This works by setting the special `$color` variable.  
 //   For a more step-by-step explanation of attachments, see the [[Attachments Tutorial|Tutorial-Attachments]].
 // Arguments:
 //   c = Color name or RGBA vector.  Default: The default color in your color scheme. 
@@ -844,11 +844,11 @@ module recolor(c="default")
 // Description:
 //   Sets the color for children at one level, reverting to the previous color for further descendants.
 //   This works only with attachables and you cannot have any color() modules above it in any parents,
-//   only recolor() or other color_this() modules.
+//   only recolor() or other color_this() modules.  This works using the `$color` and `$save_color` variables.  
 //   . 
 //   For a more step-by-step explanation of attachments, see the [[Attachments Tutorial|Tutorial-Attachments]].
 // Arguments:
-//   c = Color name or RGBA vector.  Default: the standard OpenSCAD yellow
+//   c = Color name or RGBA vector.  Default: the default color in your color scheme
 // Example:
 //   cuboid([10,10,5])
 //     color_this("green")attach(TOP,BOT) cuboid([9,9,4.5])