Index: action_details.html
===================================================================
--- action_details.html	(revision 31736)
+++ action_details.html	(revision 31737)
@@ -2663,6 +2663,67 @@
  
 </dd></dl>
 
+<h2 id="polybool">PolyBool</h2>
+<dl><dd>
+<p>
+<table border=0 cellspacing=10 class=actsum>
+<tr><th align=right class=actsum>Syntax summary:<td align=left class=actsum>
+PstkProto([noundo,] unite|isect|sub, [poly1, poly2, [poly...]])
+<tr><th align=right class=actsum>Help text:<td align=left class=actsum>
+Perform polygon boolean operation on the clipped polygons referred. A poly is either and idpath, selected, found or object (for the object under the cursor). When not specified, two object polygons are used.
+<tr><th align=right class=actsum>Registered&nbsp;by:<td align=left class=actsum>
+act_draw
+</table>
+<p>
+The boolean operation argument is one of these: 
+<ul>
+  
+<li>
+ unite: calculate the union of the polygons  
+<li>
+ isect: calculate the intersection of all polygons; the result is the area where all argument polygons are present  
+<li>
+ sub: subtract subsequent polygons from the first polygon 
+</ul>
+ 
+<p>
+ A polygon is a pcb layer object, that is: if it's fullpoly, it may have multiple islands. The result is zero or more polygon layer objects, each with a single island, created on the current layer. 
+<p>
+ The rest of the arguments will build a flat list of polygon objects to work on and need to address at least two polygons. Each argument may be one of: 
+<ul>
+  
+<li>
+ object: the user needs to click an object using the GUI  
+<li>
+ selected: all selected polygons are appended to the list  
+<li>
+ found: all found (green highlight) polygons are appended to the list  
+<li>
+ 
+<i>
+ipdath
+</i>
+: address a specific polygon 
+</ul>
+ 
+<p>
+ Note: for the 
+<i>
+sub
+</i>
+ operation the first polygon is special, so order of attributes matter. When using 
+<i>
+selected
+</i>
+ or 
+<i>
+found
+</i>
+ to address polygons, if multiple polygons are selected or found at the time, the order they end up added to the operation object list is undefined. 
+<p>
+ Input polygons are unchanged, new polygons are created on the current layer.  
+</dd></dl>
+
 <h2 id="polycombine">PolyCombine</h2>
 <dl><dd>
 <p>
Index: action_reference.html
===================================================================
--- action_reference.html	(revision 31736)
+++ action_reference.html	(revision 31737)
@@ -13,7 +13,7 @@
 <table border=1>
 <caption>
  <b>
-This is pcb-rnd 2.2.1 (svn r31696) an interactive printed circuit board editor ,  Revision: 31732
+This is pcb-rnd 2.2.1 (svn r31696) an interactive printed circuit board editor ,  Revision: 31736
 </b>
 <th> Action <th> Description <th> Syntax <th> Plugin
 <tr><td>About</td><td>Present the about box</td><td>About()</td><td>dialogs plugin</td>
@@ -269,7 +269,7 @@
 <tr><td>pcb_tan</td><td></td><td></td><td>script plugin</td>
 <tr><td>perp</td><td>Draw a line perpendicular to another line</td><td>perp()</td><td>ddraft plugin</td>
 <tr><td>Pinout</td><td>Present the subcircuit pinout box</td><td>Pinout()</td><td>dialogs plugin</td>
-<tr><td>PolyBool</td><td>Perform polygon boolean operation on the clipped polygons referred. A poly is either and idpath, selected, found or object (for the object under the cursor). When not specified, two object polygons are used.</td><td>PstkProto([noundo,] unite|isect|sub|xor, [poly1, poly2, [poly...]])</td><td>act_draw</td>
+<tr><td><a href="action_details.html#polybool">PolyBool</a></td><td>Perform polygon boolean operation on the clipped polygons referred. A poly is either and idpath, selected, found or object (for the object under the cursor). When not specified, two object polygons are used.</td><td>PstkProto([noundo,] unite|isect|sub, [poly1, poly2, [poly...]])</td><td>act_draw</td>
 <tr><td><a href="action_details.html#polycombine">PolyCombine</a></td><td></td><td></td><td>polycombine plugin</td>
 <tr><td><a href="action_details.html#polygon">Polygon</a></td><td>Some polygon related stuff.</td><td>Polygon(Close|CloseHole|PreviousPoint)</td><td></td>
 <tr><td>PolyHatch</td><td>hatch the selected polygon(s) with lines of the current style; lines are drawn on the current layer; flags are h:horizontal, v:vertical, c:contour, p:poly</td><td>PolyHatch([spacing], [hvcp])<br>PolyHatch(interactive)</td><td>lib_polyhelp</td>