diff --git a/docs/docs/imaging.xml b/docs/docs/imaging.xml
index dc2b2531f..7b0098073 100644
--- a/docs/docs/imaging.xml
+++ b/docs/docs/imaging.xml
@@ -119,6 +119,9 @@
          <item>separable_3x3_filter_block_grayscale</item> 
          <item>separable_3x3_filter_block_rgb</item> 
          <item>pyramid_down</item> 
+         <item>pyramid_down_3_2</item> 
+         <item>pyramid_down_4_3</item> 
+         <item>pyramid_down_5_4</item> 
          <item>zero_border_pixels</item> 
 
          <item>binary_dilation</item>
@@ -859,7 +862,47 @@
          <file>dlib/image_transforms.h</file>
          <spec_file link="true">dlib/image_transforms/image_pyramid_abstract.h</spec_file>
          <description>        
-               This is a simple function object to help create image pyramids.
+               This is a simple function object to help create image pyramids.  It 
+               downsamples an image by half.
+         </description>
+                                 
+      </component>
+            
+   <!-- ************************************************************************* -->
+      
+      <component>
+         <name>pyramid_down_3_2</name>
+         <file>dlib/image_transforms.h</file>
+         <spec_file link="true">dlib/image_transforms/image_pyramid_abstract.h</spec_file>
+         <description>        
+               This is a simple function object to help create image pyramids.  It 
+               downsamples an image by a ratio of 3 to 2.
+         </description>
+                                 
+      </component>
+            
+   <!-- ************************************************************************* -->
+      
+      <component>
+         <name>pyramid_down_4_3</name>
+         <file>dlib/image_transforms.h</file>
+         <spec_file link="true">dlib/image_transforms/image_pyramid_abstract.h</spec_file>
+         <description>        
+               This is a simple function object to help create image pyramids.  It 
+               downsamples an image by a ratio of 4 to 3.
+         </description>
+                                 
+      </component>
+            
+   <!-- ************************************************************************* -->
+      
+      <component>
+         <name>pyramid_down_5_4</name>
+         <file>dlib/image_transforms.h</file>
+         <spec_file link="true">dlib/image_transforms/image_pyramid_abstract.h</spec_file>
+         <description>        
+               This is a simple function object to help create image pyramids.  It 
+               downsamples an image by a ratio of 5 to 4.
          </description>
                                  
       </component>
diff --git a/docs/docs/term_index.xml b/docs/docs/term_index.xml
index ecb9ea741..bfdc63048 100644
--- a/docs/docs/term_index.xml
+++ b/docs/docs/term_index.xml
@@ -954,6 +954,9 @@
          <term file="imaging.html" name="separable_3x3_filter_block_grayscale"/>
          <term file="imaging.html" name="separable_3x3_filter_block_rgb"/>
          <term file="imaging.html" name="pyramid_down"/>
+         <term file="imaging.html" name="pyramid_down_3_2"/>
+         <term file="imaging.html" name="pyramid_down_4_3"/>
+         <term file="imaging.html" name="pyramid_down_5_4"/>
          <term file="imaging.html" name="threshold_image"/>
          <term file="imaging.html" name="auto_threshold_image"/>
          <term file="imaging.html" name="png_loader"/>