API: add docs to `api_item_get_user()`

and remove commented out lines

diff --git a/include/api.php b/include/api.php
index 4a3d60969362c91dcc695d33ab2473f3aa391b2f..1d4f5d58745b3333ca56cd7cc93ab98fe9b01052 100644 (file)
--- a/include/api.php
+++ b/include/api.php
@@ -653,6 +653,13 @@
 
        }
 
+       /**
+        * @brief return api-formatted array for item's author and owner
+        *
+        * @param App $a
+        * @param array $item : item from db
+        * @return array(array:author, array:owner)
+        */
        function api_item_get_user(&$a, $item) {
 
                // Make sure that there is an entry in the global contacts for author and owner
@@ -662,12 +669,6 @@
                get_gcontact_id(array("url" => $item['owner-link'], "network" => $item['network'],
                                        "photo" => $item['owner-avatar'], "name" => $item['owner-name']));
 
-               // Comments in threads may appear as wall-to-wall postings.
-               // So only take the owner at the top posting.
-               #if ($item["id"] == $item["parent"])
-               #       $status_user = api_get_user($a,$item["owner-link"]);
-               #else
-
                $status_user = api_get_user($a,$item["author-link"]);
                $status_user["protected"] = (($item["allow_cid"] != "") OR
                                                ($item["allow_gid"] != "") OR