Index: wp-includes/cron.php
===================================================================
--- wp-includes/cron.php	(revision 6603)
+++ wp-includes/cron.php	(working copy)
@@ -1,5 +1,18 @@
 <?php
 
+/**
+ * wp_schedule_single_event() - Schedule a one-time event via cron
+ *
+ * Schedules a hook which will be executed once by the Wordpress actions core at a time which you
+ * specify. The action will fire off when someone visits your WordPress site, if the schedule time
+ * has passed.
+ *
+ * @since 2.1.0
+ *
+ * @param int $timestamp UNIX timestamp of when the event should occur
+ * @param string $hook The name of an action hook to execute
+ * @param array $args optional Arguments to pass to the hook function(s)
+ */
 function wp_schedule_single_event( $timestamp, $hook, $args = array()) {
 	$crons = _get_cron_array();
 	$key = md5(serialize($args));
@@ -8,6 +21,20 @@
 	_set_cron_array( $crons );
 }
 
+/**
+ * wp_schedule_event() - Schedule a periodic event
+ *
+ * Schedules a hook which will be executed by the WordPress actions core on a specific interval,
+ * specified by you. The action will trigger when someone visits your WordPress site, if the
+ * scheduled time has passed.
+ *
+ * @since 2.1.0
+ *
+ * @param int $timestamp UNIX timestamp of the first time the event should occur
+ * @param string $recurrence How often the event should recur
+ * @param string $hook The name of an action hook to execute
+ * @param array $args optional Arguments to pass to the hook function(s)
+ */
 function wp_schedule_event( $timestamp, $recurrence, $hook, $args = array()) {
 	$crons = _get_cron_array();
 	$schedules = wp_get_schedules();
@@ -19,6 +46,16 @@
 	_set_cron_array( $crons );
 }
 
+/**
+ * wp_reschedule_event() - Reschedule a recurring event
+ *
+ * @since 2.1.0
+ *
+ * @param int $timestamp UNIX timestamp to reschedule to
+ * @param string $recurrence How often the event should recur
+ * @param string $hook The name of an action hook to execute
+ * @param array $args optional Arguments to pass to the hook function(s)
+ */
 function wp_reschedule_event( $timestamp, $recurrence, $hook, $args = array()) {
 	$crons = _get_cron_array();
 	$schedules = wp_get_schedules();
@@ -41,6 +78,17 @@
 	wp_schedule_event( $timestamp, $recurrence, $hook, $args );
 }
 
+/**
+ * wp_unschedule_event() - Unschedule a previously-scheduled cron job
+ *
+ * The $timestamp and $hook parameters are required so that the event can be identified.
+ *
+ * @since 2.1.0
+ *
+ * @param int $timestamp UNIX timestamp of the next occurence when the scheduled hook was set to run
+ * @param string $hook The name of an action hook for the event
+ * @param array $args optional Arguments to pass to the hook function(s)
+ */
 function wp_unschedule_event( $timestamp, $hook, $args = array() ) {
 	$crons = _get_cron_array();
 	$key = md5(serialize($args));
@@ -52,6 +100,13 @@
 	_set_cron_array( $crons );
 }
 
+/**
+ * wp_clear_scheduled_hook() - Unschedule all cron jobs attached to a specific hook
+ *
+ * @since 2.1.0
+ *
+ * @param string $hook The name of an action hook
+ */
 function wp_clear_scheduled_hook( $hook ) {
 	$args = array_slice( func_get_args(), 1 );
 
@@ -59,6 +114,15 @@
 		wp_unschedule_event( $timestamp, $hook, $args );
 }
 
+/**
+ * wp_next_scheduled() - Return the next timestamp for a cron event
+ *
+ * @since 2.1.0
+ *
+ * @param string $hook Name of the action hook.
+ * @param array $args optional Arguments to pass to the hook function(s)
+ * @return int The UNIX timestamp of the next time the scheduled event will occur
+ */
 function wp_next_scheduled( $hook, $args = array() ) {
 	$crons = _get_cron_array();
 	$key = md5(serialize($args));
@@ -71,6 +135,15 @@
 	return false;
 }
 
+/**
+ * spawn_cron() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.1.0
+ *
+ * @return unknown
+ */
 function spawn_cron() {
 	$crons = _get_cron_array();
 
@@ -104,6 +177,13 @@
 		);
 }
 
+/**
+ * wp_cron() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.1.0
+ */
 function wp_cron() {
 	// Prevent infinite loops caused by lack of wp-cron.php
 	if ( strpos($_SERVER['REQUEST_URI'], '/wp-cron.php') !== false )
@@ -130,6 +210,13 @@
 	}
 }
 
+/**
+ * wp_get_schedules() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.1.0
+ */
 function wp_get_schedules() {
 	$schedules = array(
 		'hourly' => array( 'interval' => 3600, 'display' => __('Once Hourly') ),
@@ -138,6 +225,17 @@
 	return array_merge( apply_filters( 'cron_schedules', array() ), $schedules );
 }
 
+/**
+ * wp_get_schedule() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.1.0
+ *
+ * @param string $hook The name of an action hook
+ * @param array $args optional Arguments to pass to the hook function(s)
+ * @return string|bool
+ */
 function wp_get_schedule($hook, $args = array()) {
 	$crons = _get_cron_array();
 	$key = md5(serialize($args));
@@ -154,6 +252,16 @@
 // Private functions
 //
 
+/**
+ * _get_cron_array() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}
+ *
+ * @since 2.1.0
+ * @access private
+ *
+ * @return unknown
+ */
 function _get_cron_array()  {
 	$cron = get_option('cron');
 	if ( ! is_array($cron) )
@@ -167,11 +275,32 @@
 	return $cron;
 }
 
+/**
+ * set_cron_array() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.1.0
+ * @access private
+ *
+ * @param array $cron Cron info array from _get_cron_array()
+ */
 function _set_cron_array($cron) {
 	$cron['version'] = 2;
 	update_option( 'cron', $cron );
 }
 
+/**
+ * _update_cron_array() - Upgrade a Cron info array
+ *
+ * This function upgrades the Cron info array to version 2.
+ *
+ * @since 2.1.0
+ * @access private
+ *
+ * @param array $cron Cron info array from _get_cron_array()
+ * @return array An upgraded Cron info array
+ */
 function _upgrade_cron_array($cron) {
 	if ( isset($cron['version']) && 2 == $cron['version'])
 		return $cron;
@@ -190,4 +319,4 @@
 	return $new_cron;
 }
 
-?>
+?>
\ No newline at end of file