From de3b7b55d68ebad3d535dad2643e747460dc22a3 Mon Sep 17 00:00:00 2001
From: Mark Haines <mark.haines@matrix.org>
Date: Wed, 12 Aug 2015 14:29:17 +0100
Subject: [PATCH] Doc-string for config ultility function

---
 synapse/config/repository.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/synapse/config/repository.py b/synapse/config/repository.py
index 7cab87442..2cb0812d7 100644
--- a/synapse/config/repository.py
+++ b/synapse/config/repository.py
@@ -21,6 +21,17 @@ ThumbnailRequirement = namedtuple(
 )
 
 def parse_thumbnail_requirements(thumbnail_sizes):
+    """ Takes a list of dictionaries with "width", "height", and "method" keys
+    and creates a map from image media types to the thumbnail size, thumnailing
+    method, and thumbnail media type to precalculate
+
+    Args:
+        thumbnail_sizes(list): List of dicts with "width", "height", and
+            "method" keys
+    Returns:
+        Dictionary mapping from media type string to list of
+        ThumbnailRequirement tuples.
+    """
     requirements = {}
     for size in thumbnail_sizes:
         width = size["width"]