Index: trunk/doc/user/09_appendix/action_details.html
===================================================================
--- trunk/doc/user/09_appendix/action_details.html	(revision 29589)
+++ trunk/doc/user/09_appendix/action_details.html	(revision 29590)
@@ -1431,9 +1431,91 @@
 <td>
  Compares the list of subcircuits needed since the most recent           
 <i>Start</i>
- with the list of subcircuits actually on the           board. Any subcircuits that weren't listed are selected, so           that the user may delete them.  
+ with the list of subcircuits actually on the           board. Any subcircuits that weren't listed are selected, so           that the user may delete them. 
 </table>
+ 
+<p>
+ Placement of new subcircuits depends on conf node  import/footprint_placement/method, which is a string containing a one word instruction that is one of: 
+<p>
+ 
+<table border=1 cellspacing=0>
    
+<tr>
+
+<th>
+ disperse      
+<td>
+ place all new subcircuits at randomized coordinates around           
+<i>
+location
+</i>
+, within a distance configured in           import/footprint_placement/disperse   
+<tr>
+
+<th>
+ frame      
+<td>
+ place all new subcircuits close outside of the drawing area,           "framing" the design  
+</table>
+  
+<p>
+ 
+<i>
+Location
+</i>
+ is a string instruction specified by import/footprint_placement/location, the value is one of: 
+<p>
+ 
+<table border=1 cellspacing=0>
+   
+<tr>
+
+<th>
+ (empty, no value)      
+<td>
+ place around the coordinates specified in coords           import/footprint_placement/x and import/footprint_placement/y   
+<tr>
+
+<th>
+ center      
+<td>
+ place around the center of the drawing area   
+<tr>
+
+<th>
+ mark      
+<td>
+ place around the mark (or center of the drawing area if no mark present           at the moment of import)  
+</table>
+  
+<p>
+ Removal of excess subcircuits (the ones present on the board but not in the new netlist) depends on conf node import/footprint_removalt/method, which is a string containing a one word instruction that is one of: 
+<p>
+ 
+<table border=1 cellspacing=0>
+   
+<tr>
+
+<th>
+ select (or empty)      
+<td>
+ select excess subcircuits (an {s r} after the import removes them)   
+<tr>
+
+<th>
+ remove      
+<td>
+ automatically remove excess subcircuits   
+<tr>
+
+<th>
+ list      
+<td>
+ no change on excess subcircuit data on the board, but           open a view list dialog enumerating them  
+</table>
+  
+<p>
+ Note: subcircuits with the nonetlist flag set or empty/missing refdes will not be taken as excess even if they are not present on the netlist.   
 </dd></dl>
 
 <h2 id="elementsetattr">ElementSetAttr</h2>
Index: trunk/doc/user/09_appendix/action_reference.html
===================================================================
--- trunk/doc/user/09_appendix/action_reference.html	(revision 29589)
+++ trunk/doc/user/09_appendix/action_reference.html	(revision 29590)
@@ -13,7 +13,7 @@
 <table border=1>
 <caption>
  <b>
-This is pcb-rnd 2.2.0 (svn r29554) an interactive printed circuit board editor ,  Revision: 29569
+This is pcb-rnd 2.2.0 (svn r29554) an interactive printed circuit board editor ,  Revision: 29589
 </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>
@@ -356,7 +356,7 @@
 <tr><td><a href="action_details.html#unloadscript">UnloadScript</a></td><td>Unload a fungw script</td><td>UnloadScript(id)</td><td>script plugin</td>
 <tr><td>UnloadVendor</td><td>Unloads the current vendor drill mapping table.</td><td>UnloadVendor()</td><td>vendor drill mapping</td>
 <tr><td><a href="action_details.html#unselect">Unselect</a></td><td>Unselects the object at the pointer location or the specified objects.</td><td>Unselect(All|Block|Connection)</td><td></td>
-<tr><td>ViewList</td><td>Present a new empty view list</td><td>viewlist([name, [winid]])</td><td>dialogs plugin</td>
+<tr><td>ViewList</td><td>Present a new empty view list</td><td>viewlist([name, [winid, [listptr]]])</td><td>dialogs plugin</td>
 <tr><td><a href="action_details.html#w">w</a></td><td>Saves layout data.</td><td>s [name]<br>w [name]</td><td>shand_cmd plugin</td>
 <tr><td><a href="action_details.html#wq">wq</a></td><td>Saves the layout data and quits.</td><td>wq</td><td>shand_cmd plugin</td>
 <tr><td><a href="action_details.html#zoom">Zoom</a></td><td>GUI zoom</td><td>Zoom()<br>Zoom([+|-|=]factor)<br>Zoom(x1, y1, x2, y2)<br>Zoom(selected)<br>Zoom(?)<br>Zoom(get)<br>Zoom(found)</td><td>lib_hid_pcbui/actions</td>
Index: trunk/doc/user/09_appendix/action_src/elementlist.html
===================================================================
--- trunk/doc/user/09_appendix/action_src/elementlist.html	(revision 29589)
+++ trunk/doc/user/09_appendix/action_src/elementlist.html	(revision 29590)
@@ -16,7 +16,65 @@
 	         <arg>Start</arg> with the list of subcircuits actually on the
 	         board. Any subcircuits that weren't listed are selected, so
 	         that the user may delete them.
+</table>
+<p>
+Placement of new subcircuits depends on conf node 
+import/footprint_placement/method, which is a string containing
+a one word instruction that is one of:
+<p>
+<table border=1 cellspacing=0>
 
+	<tr><th> disperse
+	    <td> place all new subcircuits at randomized coordinates around
+	         <i>location</i>, within a distance configured in
+	         import/footprint_placement/disperse
+
+	<tr><th> frame
+	    <td> place all new subcircuits close outside of the drawing area,
+	         "framing" the design
+
 </table>
 
+<p>
+<i>Location</i> is a string instruction specified by
+import/footprint_placement/location, the value is one of:
+<p>
+<table border=1 cellspacing=0>
 
+	<tr><th> (empty, no value)
+	    <td> place around the coordinates specified in coords
+	         import/footprint_placement/x and import/footprint_placement/y
+
+	<tr><th> center
+	    <td> place around the center of the drawing area
+
+	<tr><th> mark
+	    <td> place around the mark (or center of the drawing area if no mark present
+	         at the moment of import)
+
+</table>
+
+<p>
+Removal of excess subcircuits (the ones present on the board but not in
+the new netlist) depends on conf node import/footprint_removalt/method,
+which is a string containing a one word instruction that is one of:
+<p>
+<table border=1 cellspacing=0>
+
+	<tr><th> select (or empty)
+	    <td> select excess subcircuits (an {s r} after the import removes them)
+
+	<tr><th> remove
+	    <td> automatically remove excess subcircuits
+
+	<tr><th> list
+	    <td> no change on excess subcircuit data on the board, but
+	         open a view list dialog enumerating them
+
+</table>
+
+<p>
+Note: subcircuits with the nonetlist flag set or empty/missing refdes
+will not be taken as excess even if they are not present on the netlist.
+
+