updated docs

docs/docs/linear_algebra.xml

@@ -594,6 +594,7 @@
          <item>point_transform</item> 
          <item>point_transform_affine</item> 
          <item>find_affine_transform</item> 
+         <item>find_similarity_transform</item> 
          <item>point_transform_projective</item> 
          <item>find_projective_transform</item> 
          <item>rotation_matrix</item> 
@@ -1065,6 +1066,22 @@
                                  
       </component>
 
+   <!-- ************************************************************************* -->
+
+      <component>
+         <name>find_similarity_transform</name>
+         <file>dlib/geometry.h</file>
+         <spec_file link="true">dlib/geometry/point_transforms_abstract.h</spec_file>
+         <description>        
+            This is a routine that takes in two sets of points and finds the
+            best <a href="#point_transform_affine">affine transformation</a>
+            that maps between them.  However, it considers only rotations, translations,
+            and uniform scale changes in finding the mapping.  Therefore, it finds
+            a similarity transformation rather than a general affine transform.
+         </description>
+                                 
+      </component>
+
    <!-- ************************************************************************* -->
 
       <component>

docs/docs/term_index.xml

@@ -239,6 +239,7 @@
          <term file="linear_algebra.html" name="point_transform"           include="dlib/geometry.h"/>
          <term file="linear_algebra.html" name="point_transform_affine"    include="dlib/geometry.h"/>
          <term file="linear_algebra.html" name="find_affine_transform"     include="dlib/geometry.h"/>
+         <term file="linear_algebra.html" name="find_similarity_transform" include="dlib/geometry.h"/>
          <term file="linear_algebra.html" name="point_transform_projective"    include="dlib/geometry.h"/>
          <term file="linear_algebra.html" name="find_projective_transform"     include="dlib/geometry.h"/>
          <term file="linear_algebra.html" name="rotation_matrix"           include="dlib/geometry.h"/>