From 410ebb4cbf0a674967a8599647a042922ea3d5ef Mon Sep 17 00:00:00 2001
From: Michael Vogel <icarus@dabo.de>
Date: Thu, 28 Jan 2016 12:35:07 +0100
Subject: [PATCH] Added documentation

---
 include/Photo.php | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/include/Photo.php b/include/Photo.php
index e0cb23008..3f1608d3e 100644
--- a/include/Photo.php
+++ b/include/Photo.php
@@ -720,6 +720,15 @@ function guess_image_type($filename, $fromcurl=false) {
 
 }
 
+/**
+ * @brief Updates the avatar links in a contact only if needed
+ *
+ * @param string $avatar Link to avatar picture
+ * @param int $uid User id of contact owner
+ * @param int $cid Contact id
+ *
+ * @return array Returns array of the different avatar sizes
+ */
 function update_contact_avatar($avatar,$uid,$cid) {
 
 	$r = q("SELECT `avatar`, `photo`, `thumb`, `micro` FROM `contact` WHERE `id` = %d LIMIT 1", intval($cid));