Added some comments

diff --git a/include/items.php b/include/items.php
index 41d13616ea0e0f5fc79521e2e9946a3a93dff8ae..93df36fb39dcdd7c07b0943bdba09fd25b956950 100644 (file)
--- a/include/items.php
+++ b/include/items.php
@@ -922,11 +922,8 @@ function item_store($arr,$force_parent = false, $notify = false, $dontcache = fa
        create_tags_from_item($current_post);
        create_files_from_item($current_post);
 
-       /**
-        * If this is now the last-child, force all _other_ children of this parent to *not* be last-child
-        * It is done after the transaction to avoid dead locks.
-        */
-
+       // If this is now the last-child, force all _other_ children of this parent to *not* be last-child
+       // It is done after the transaction to avoid dead locks.
        if ($arr['last-child']) {
                $r = q("UPDATE `item` SET `last-child` = 0 WHERE `parent-uri` = '%s' AND `uid` = %d AND `id` != %d",
                        dbesc($arr['uri']),

diff --git a/include/threads.php b/include/threads.php
index 8dfb41252573c47f6c45f6a6805a2de722580876..3d9b656ea360c56ac3242e0b01a6685ecb25284d 100644 (file)
--- a/include/threads.php
+++ b/include/threads.php
@@ -23,7 +23,7 @@ function add_thread($itemid, $onlyshadow = false) {
 }
 
 /**
- * @brief Add a shadow entry for a given item id
+ * @brief Add a shadow entry for a given item id that is a thread starter
  *
  * We store every public item entry additionally with the user id "0".
  * This is used for the community page and for the search.
@@ -113,6 +113,13 @@ function add_shadow_thread($itemid) {
        }
 }
 
+/**
+ * @brief Add a shadow entry for a given item id that is a comment
+ *
+ * This function does the same like the function above - but for comments
+ *
+ * @param integer $itemid Item ID that should be added
+ */
 function add_shadow_entry($itemid) {
 
        $items = q("SELECT * FROM `item` WHERE `id` = %d", intval($itemid));