Revision: 71664
          http://sourceforge.net/p/brlcad/code/71664
Author:   starseeker
Date:     2018-09-06 15:50:57 +0000 (Thu, 06 Sep 2018)
Log Message:
-----------
Make note of a couple handy search -exec tricks for facetize conversion mucking

Modified Paths:
--------------
    brlcad/trunk/doc/docbook/system/mann/facetize.xml

Modified: brlcad/trunk/doc/docbook/system/mann/facetize.xml
===================================================================
--- brlcad/trunk/doc/docbook/system/mann/facetize.xml   2018-09-06 15:49:24 UTC 
(rev 71663)
+++ brlcad/trunk/doc/docbook/system/mann/facetize.xml   2018-09-06 15:50:57 UTC 
(rev 71664)
@@ -215,6 +215,37 @@
     </para>
   </refsection>
   
+  <refsection xml:id="util">
+    <title>USEFUL TRICKS</title>
+    <para>
+      These are some useful tricks for targeted manipulation of the 
facetization process.
+    </para>
+    <example>
+      <title>Reset CM state of a subset of objects.</title>
+      <para>
+       Use search -exec to reset just the continuation method flag (will 
result in resume
+       retrying CM on all missing objects, without triggering the full retry 
of all methods
+       entailed by the --retry option.)  More targeted searches can do this 
reset for more
+       narrow subsets of the .g database.
+      </para>
+      <para>
+       <prompt>mged&gt;</prompt> <userinput>search -attr facetize:CM -exec 
attr rm "{}" facetize:CM ";"</userinput>
+      </para>
+    </example>
+    
+    <example>
+      <title>List invalid BoT objects below a comb</title>
+      <para>
+       Use search -exec and a Tcl proc to report on invalid objects below a 
comb.
+      </para>
+      <para>
+       <prompt>mged&gt;</prompt> <userinput>proc echoinvalid {objname} { if 
{!\[bot check solid $objname\] } { puts $objname } }</userinput>
+       <prompt>mged&gt;</prompt> <userinput>search comb -type bot -exec 
echoinvalid "{}" ";"</userinput>
+      </para>
+    </example>
+    
+  </refsection>
+  
   <refsection xml:id="author">
     <title>AUTHOR</title>
     <para>BRL-CAD Team</para>

This was sent by the SourceForge.net collaborative development platform, the 
world's largest Open Source development site.


------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
BRL-CAD Source Commits mailing list
brlcad-commits@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/brlcad-commits

Reply via email to