Ticket #24742: 24742.diff

wp-admin/includes/revision.php

@@ -1 +1 @@
 <?php
+/**
+ * WordPress Administration Revisions API.
+ *
+ * @package WordPress
+ * @subpackage Administrator
+ */
 
+/**
+ * Get the revision UI diff
+ *
+ * @param object $post The post object.
+ * @param int $compare_from The post id to compare from.
+ * @param int $compare_to The post id to come to.
+ *
+ * @return array|bool
+ */
 function wp_get_revision_ui_diff( $post, $compare_from, $compare_to ) {
         if ( ! $post = get_post( $post ) )
                 return false;
@@ -61 +76 @@
         return $return;
 }
 
+/**
+ * Prepare revisions for JavaScript
+ *
+ * @param object $post The post object.
+ * @param int $selected_revision_id The selected revision id.
+ * @param int $from (optional) The revision id to compare from.
+ *
+ * @return array An associative array of revision data.
+ */
 function wp_prepare_revisions_for_js( $post, $selected_revision_id, $from = null ) {
         $post = get_post( $post );
         $revisions = array();