Changeset 6526 for trunk/src/includes/replies/functions.php

Timestamp:

06/12/2017 02:21:34 PM (9 years ago)

Author:

johnjamesjacoby

Message:

Documentation: Don't use reply's, because it looks weird and is poor English grammar.

Prefer more descriptive documentation instead.

File:

• trunk/src/includes/replies/functions.php (modified) (6 diffs)

trunk/src/includes/replies/functions.php

@@ -838 +838 @@
  * @uses bbp_update_reply_topic_id() To update the reply topic id
  * @uses bbp_update_reply_to() To update the reply to id
- * @uses bbp_update_reply_walker() To update the reply's ancestors' counts
+ * @uses bbp_update_reply_walker() To update the ancestor counts of a reply
  */
 function bbp_update_reply( $reply_id = 0, $topic_id = 0, $forum_id = 0, $anonymous_data = array(), $author_id = 0, $is_edit = false, $reply_to = 0 ) {
@@ -1063 +1063 @@
  * @uses bbp_get_reply_id() To get the reply id
  * @uses bbp_get_forum_id() To get the forum id
- * @uses get_post_ancestors() To get the reply's forum
+ * @uses get_post_ancestors() To get the ancestors of a reply
  * @uses get_post_field() To get the post type of the post
  * @uses update_post_meta() To update the reply forum id meta
  * @uses apply_filters() Calls 'bbp_update_reply_forum_id' with the forum id
  *                        and reply id
- * @return bool Reply's forum id
+ * @return bool The forum id of the reply
  */
 function bbp_update_reply_forum_id( $reply_id = 0, $forum_id = 0 ) {
@@ -1113 +1113 @@
  * @uses bbp_get_reply_id() To get the reply id
  * @uses bbp_get_topic_id() To get the topic id
- * @uses get_post_ancestors() To get the reply's topic
+ * @uses get_post_ancestors() To get the ancestors of a reply
  * @uses get_post_field() To get the post type of the post
  * @uses update_post_meta() To update the reply topic id meta
  * @uses apply_filters() Calls 'bbp_update_reply_topic_id' with the topic id
  *                        and reply id
- * @return bool Reply's topic id
+ * @return bool The topic id of the reply
  */
 function bbp_update_reply_topic_id( $reply_id = 0, $topic_id = 0 ) {
@@ -1155 +1155 @@
 
 /*
- * Update the reply's meta data with its reply to id
+ * Update the meta data with its parent reply-to id, of a reply
  *
  * @since 2.4.0 bbPress (r4944)
@@ -1165 +1165 @@
  * @uses apply_filters() Calls 'bbp_update_reply_to' with the reply id and
  *                        and reply to id
- * @return bool Reply's parent reply id
+ * @return bool The parent reply id of the reply
  */
 function bbp_update_reply_to( $reply_id = 0, $reply_to = 0 ) {
@@ -1343 +1343 @@
     /** Topic to Move From ***************************************************/
 
-    // Get the reply's current topic
+    // Get the current topic a reply is in
     $source_topic = bbp_get_topic( $move_reply->post_parent );