From 4284b86ba96ed188904a7c77cd4e909a68740669 Mon Sep 17 00:00:00 2001
From: Adrian Mariano <avm4@cornell.edu>
Date: Tue, 28 May 2024 19:55:21 -0400
Subject: [PATCH] doc tweak

---
 attachments.scad | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/attachments.scad b/attachments.scad
index 82b9066..f7d4311 100644
--- a/attachments.scad
+++ b/attachments.scad
@@ -779,7 +779,7 @@ function _make_anchor_legal(anchor,geom) =
 //   .
 //   If you give `inside=true` then the anchor arrows are lined up so they are pointing the same direction and
 //   the child object will be located inside the parent.  In this case a default "remove" tag is applied to
-//   the children.
+//   the children.  
 //   .
 //   Because the attachment process forces an orientation and anchor point for the child, it overrides
 //   any such specifications you give to the child:  **both `anchor=` and `orient=` given to the child are
@@ -797,10 +797,17 @@ function _make_anchor_legal(anchor,geom) =
 //   These options will probably be necessary, in fact, to get the child correctly positioned.  Note that
 //   giving `spin=` to `attach()` in this case is the same as applying `zrot()` to the child. 
 //   .
-//   Attached children may be ovarlapped into the parent a bit, as given by the `$overlap` value
+//   You can overlap attached children into the parent by giving the `$overlap` value
 //   which is 0 by default, or by the `overlap=` argument.    This is to prevent OpenSCAD
 //   from making non-manifold objects.  You can define `$overlap=` as an argument in a parent
-//   module to set the default for all attachments to it.
+//   module to set the default for all attachments to it.  When you give `inside=true`, a positive overlap
+//   value shifts the child object outward.
+//   .
+//   If you specify an `inset=` value then the child is shifted away from any edges it is aligned to, towards the middle
+//   of the parent.  The `shiftout=` parameter is intended to simplify differences with aligned objects
+//   placed inside the parent.  It will shift the child outward along every direction where it is aligned with
+//   the parent.  For an inside child this is equivalent to giving a positive overlap and negative inset value.
+//   For a child with `inside=false` it is equivalent to a negative overlap and negative inset.  
 //   .
 //   For a step-by-step explanation of
 //   attachments, see the [Attachments Tutorial](Tutorial-Attachments).