updated docs

docs/docs/optimization.xml

@@ -78,6 +78,7 @@
          <item>graph_cut_score</item> 
          <item>potts_model_score</item> 
          <item>parse_tree_to_string</item> 
+         <item>find_trees_not_rooted_with_tag</item> 
       </section>
 
     </top>  
@@ -551,6 +552,25 @@ However, for graphs with cycles, the solution may be approximate.
                                  
       </component>
 
+   <!-- ************************************************************************* -->
+
+      <component>
+         <name>find_trees_not_rooted_with_tag</name>
+         <file>dlib/optimization.h</file>
+         <spec_file link="true">dlib/optimization/find_max_parse_cky_abstract.h</spec_file>
+         <description>
+              Finds all the largest non-overlapping <a href="#find_max_parse_cky">parse trees</a> 
+              in tree that are not rooted with a particular tag.   
+              <p>
+              This function is useful when you want to cut a parse tree
+              into a bunch of sub-trees and you know that the top level of the tree is all
+              composed of the same kind of tag.  So if you want to just "slice off" the top
+              of the tree where this tag lives then this function is useful for doing that.
+              </p>
+         </description>
+                                 
+      </component>
+
    <!-- ************************************************************************* -->
 
       <component>

docs/docs/term_index.xml

@@ -84,6 +84,7 @@
 
          <term file="optimization.html" name="find_max_parse_cky"/>
          <term file="optimization.html" name="parse_tree_to_string"/>
+         <term file="optimization.html" name="find_trees_not_rooted_with_tag"/>
          <term link="optimization.html#parse_tree_to_string" name="parse_tree_to_string_tagged"/>
          <term file="dlib/optimization/find_max_parse_cky_abstract.h.html" name="parse_tree_to_string_error"/>
          <term file="dlib/optimization/find_max_parse_cky_abstract.h.html" name="constituent"/>