updated docs

docs/docs/linear_algebra.xml

@@ -599,6 +599,7 @@
          <item>rotation_matrix</item> 
          <item>get_rect</item> 
          <item>centered_rect</item> 
+         <item>set_aspect_ratio</item> 
          <item>center</item> 
          <item>dcenter</item> 
          <item>shrink_rect</item> 
@@ -957,6 +958,19 @@
                                  
       </component>
 
+   <!-- ************************************************************************* -->
+
+      <component>
+         <name>set_aspect_ratio</name>
+         <file>dlib/geometry.h</file>
+         <spec_file link="true">dlib/geometry/rectangle_abstract.h</spec_file>
+         <description>        
+            This function reshapes a <a href="#rectangle">rectangle</a> so that
+            it has a user specified aspect ratio.
+         </description>
+                                 
+      </component>
+
    <!-- ************************************************************************* -->
 
       <component>

docs/docs/term_index.xml

@@ -43,6 +43,7 @@
          <term file="linear_algebra.html" name="resize_rect_width" include="dlib/geometry.h"/>
          <term file="linear_algebra.html" name="resize_rect_height" include="dlib/geometry.h"/>
          <term file="linear_algebra.html" name="centered_rect" include="dlib/geometry.h"/>
+         <term file="linear_algebra.html" name="set_aspect_ratio" include="dlib/geometry.h"/>
          <term file="linear_algebra.html" name="center" include="dlib/geometry.h"/>
          <term file="linear_algebra.html" name="nearest_point" include="dlib/geometry.h"/>
          <term file="linear_algebra.html" name="distance_to_rect_edge" include="dlib/geometry.h"/>