updated docs

docs/docs/algorithms.xml

@@ -38,6 +38,7 @@
          <item>numeric_constants</item> 
          <item>put_in_range</item> 
          <item>qsort_array</item> 
+         <item>split_array</item> 
          <item>integrate_function_adapt_simp</item> 
          <item>square_root</item> 
          <item nolink="true">
@@ -668,6 +669,20 @@
       </component>
             
       
+   <!-- ************************************************************************* -->
+      
+      <component>
+         <name>split_array</name>
+         <file>dlib/array.h</file>
+         <spec_file link="true">dlib/array/array_tools_abstract.h</spec_file>
+         <description>
+            This function is used to efficiently split <a href="containers.html#array">array</a>
+            like objects into two parts.  It uses the global swap() function instead
+            of copying to move elements around, so it works on arrays of non-copyable
+            types.
+         </description>
+      </component>
+      
    <!-- ************************************************************************* -->
       
       <component>

docs/docs/term_index.xml

@@ -202,6 +202,7 @@
 
          <term file="algorithms.html" name="median"                        include="dlib/algs.h"/>
          <term file="algorithms.html" name="qsort_array"                   include="dlib/sort.h"/>
+         <term file="algorithms.html" name="split_array"                   include="dlib/array.h"/>
          <term file="algorithms.html" name="rand"                          include="dlib/rand.h"/>
          <term link="algorithms.html#rand" name="Mersenne Twister"         include="dlib/rand.h"/>
          <term file="graph_tools.html" name="graph_contains_undirected_cycle" include="dlib/graph_utils.h"/>