Index: wp-admin/includes/revision.php
===================================================================
--- wp-admin/includes/revision.php	(revision 24704)
+++ wp-admin/includes/revision.php	(working copy)
@@ -1,5 +1,20 @@
 <?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,6 +76,15 @@
 	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();