Index: includes/batch.inc =================================================================== RCS file: /cvs/drupal/drupal/includes/batch.inc,v retrieving revision 1.47 diff -u -r1.47 batch.inc --- includes/batch.inc 6 Dec 2009 16:21:58 -0000 1.47 +++ includes/batch.inc 23 Dec 2009 00:24:54 -0000 @@ -144,7 +144,7 @@ } /** - * Do one pass of execution in JavaScript-mode and return progress to the browser. + * Do one execution pass in JavaScript-mode and return progress to the browser. * * @see _batch_progress_page_js() * @see _batch_process() Index: includes/cache-install.inc =================================================================== RCS file: /cvs/drupal/drupal/includes/cache-install.inc,v retrieving revision 1.6 diff -u -r1.6 cache-install.inc --- includes/cache-install.inc 3 Nov 2009 05:18:06 -0000 1.6 +++ includes/cache-install.inc 23 Dec 2009 00:24:54 -0000 @@ -2,13 +2,18 @@ // $Id: cache-install.inc,v 1.6 2009/11/03 05:18:06 webchick Exp $ /** - * A stub cache implementation to be used during the installation - * process when database access is not yet available. Because Drupal's - * caching system never requires that cached data be present, these - * stub functions can short-circuit the process and sidestep the - * need for any persistent storage. Obviously, using this cache - * implementation during normal operations would have a negative impact - * on performance. + * @file + * Provides a stub cache implementation to be used during installation. + */ + +/** + * A stub cache implementation to be used during the installation process. + * + * The stub implementation is needed when database access is not yet available. + * Because Drupal's caching system never requires that cached data be present, + * these stub functions can short-circuit the process and sidestep the need for + * any persistent storage. Obviously, using this cache implementation during + * normal operations would have a negative impact on performance. */ class DrupalFakeCache extends DrupalDatabaseCache implements DrupalCacheInterface { function get($cid) { Index: includes/session.inc =================================================================== RCS file: /cvs/drupal/drupal/includes/session.inc,v retrieving revision 1.74 diff -u -r1.74 session.inc --- includes/session.inc 12 Dec 2009 20:55:18 -0000 1.74 +++ includes/session.inc 23 Dec 2009 00:24:55 -0000 @@ -314,7 +314,7 @@ * * Cleanup a specific session. * - * @param string $sid + * @param $sid * Session ID. */ function _drupal_session_destroy($sid) { @@ -356,7 +356,7 @@ /** * End a specific user's session(s). * - * @param string $uid + * @param $uid * User ID. */ function drupal_session_destroy_uid($uid) { @@ -370,7 +370,7 @@ * * Cleanup stalled sessions. * - * @param int $lifetime + * @param $lifetime * The value of session.gc_maxlifetime, passed by PHP. * Sessions not updated for more than $lifetime seconds will be removed. */ Index: includes/file.inc =================================================================== RCS file: /cvs/drupal/drupal/includes/file.inc,v retrieving revision 1.199 diff -u -r1.199 file.inc --- includes/file.inc 5 Nov 2009 03:37:08 -0000 1.199 +++ includes/file.inc 23 Dec 2009 00:24:55 -0000 @@ -7,6 +7,8 @@ */ /** + * Manually include stream wrapper code. + * * Stream wrapper code is included here because there are cases where * File API is needed before a bootstrap, or in an alternate order (e.g. * maintenance theme). @@ -60,10 +62,11 @@ define('FILE_EXISTS_ERROR', 2); /** - * File status -- This bit in the status indicates that the file is permanent - * and should not be deleted during file garbage collection process. Temporary - * files older than DRUPAL_MAXIMUM_TEMP_FILE_AGE will be removed during cron - * runs. + * Indicates that the file is permanent and should not be deleted. + * + * Temporary files older than DRUPAL_MAXIMUM_TEMP_FILE_AGE will be removed + * during cron runs, but permanent files will not be removed during the file + * garbage collection process. */ define('FILE_STATUS_PERMANENT', 1); @@ -227,7 +230,7 @@ } /** - * Returns a reference to the stream wrapper class responsible for a given URI (stream). + * Returns a reference to the stream wrapper class responsible for a given URI. * * The scheme determines the stream wrapper class that should be * used by consulting the stream wrapper registry. @@ -438,7 +441,7 @@ * should be supplied in the form array('field_name' => 'field_value'). * * @return - * An array of file objects, indexed by fid. + * An array of file objects, indexed by fid. * * @see hook_file_load() * @see file_load() @@ -451,7 +454,7 @@ * Load a file object from the database. * * @param $fid - * A file ID. + * A file ID. * @return * A file object. * @@ -562,8 +565,7 @@ } /** - * Copy a file to a new location without calling any hooks or making any - * changes to the database. + * Copy a file to a new location without invoking the file API. * * This is a powerful function that in many ways performs like an advanced * version of copy(). @@ -1357,8 +1359,7 @@ } /** - * If the file is an image verify that its dimensions are within the specified - * maximum and minimum dimensions. + * Verify that image dimensions are within the specified maximum and minimum. * * Non-image files will be ignored. If a image toolkit is available the image * will be scalled to fit within the desired maximum dimensions. @@ -1469,8 +1470,7 @@ } /** - * Save a string to the specified destination without calling any hooks or - * making any changes to the database. + * Save a string to the specified destination without invoking file API. * * This function is identical to file_save_data() except the file will not be * saved to the {file} table and none of the file_* hooks will be called. @@ -1505,8 +1505,9 @@ } /** - * Transfer file using HTTP to client. Pipes a file through Drupal to the - * client. + * Transfer file using HTTP to client. + * + * Pipes a file through Drupal to the client. * * @param $uri * String specifying the file URI to transfer. @@ -1721,15 +1722,16 @@ * Set the permissions on a file or directory. * * This function will use the 'file_chmod_directory' and 'file_chmod_file' - * variables for the default modes for directories and uploaded/generated files. - * By default these will give everyone read access so that users accessing the - * files with a user account without the webserver group (e.g. via FTP) can read - * these files, and give group write permissions so webserver group members - * (e.g. a vhost account) can alter files uploaded and owned by the webserver. - * - * PHP's chmod does not support stream wrappers so we use our wrapper implementation - * which interfaces with chmod() by default. Contrib wrappers may override this - * bahavior in their implementations as needed. + * variables for the default modes for directories and uploaded/generated + * files. By default these will give everyone read access so that users + * accessing the files with a user account without the webserver group (e.g. + * via FTP) can read these files, and give group write permissions so webserver + * group members (e.g. a vhost account) can alter files uploaded and owned by + * the webserver. + * + * PHP's chmod does not support stream wrappers so we use our wrapper + * implementation which interfaces with chmod() by default. Contrib wrappers + * may override this bahavior in their implementations as needed. * * @param $uri * A string containing a URI file, or directory path. @@ -1823,7 +1825,7 @@ * @ingroup php_wrappers */ function drupal_dirname($uri) { - $scheme = file_uri_scheme($uri); + $scheme = file_uri_scheme($uri); if ($scheme && file_stream_wrapper_valid_scheme($scheme)) { $target = file_uri_target($uri); @@ -1899,7 +1901,7 @@ * @ingroup php_wrappers */ function drupal_tempnam($directory, $prefix) { - $scheme = file_uri_scheme($directory); + $scheme = file_uri_scheme($directory); if ($scheme && file_stream_wrapper_valid_scheme($scheme)) { $wrapper = file_stream_wrapper_get_instance_by_scheme($scheme); Index: includes/cache.inc =================================================================== RCS file: /cvs/drupal/drupal/includes/cache.inc,v retrieving revision 1.42 diff -u -r1.42 cache.inc --- includes/cache.inc 4 Dec 2009 16:31:04 -0000 1.42 +++ includes/cache.inc 23 Dec 2009 00:24:54 -0000 @@ -30,9 +30,10 @@ } /** - * Return data from the persistent cache. Data may be stored as either plain - * text or as serialized data. cache_get will automatically return - * unserialized objects and arrays. + * Return data from the persistent cache + * + * Data may be stored as either plain text or as serialized data. cache_get + * will automatically return unserialized objects and arrays. * * @param $cid * The cache ID of the data to retrieve. @@ -42,7 +43,8 @@ * 'cache_menu', 'cache_page', 'cache_path', 'cache_update' or 'cache' for * the default cache. * - * @return The cache or FALSE on failure. + * @return + * The cache or FALSE on failure. */ function cache_get($cid, $bin = 'cache') { return _cache_get_object($bin)->get($cid); @@ -107,10 +109,10 @@ * * - smaller bins mean smaller database tables and allow for faster selects and * inserts - * - we try to put fast changing cache items and rather static ones into different - * bins. The effect is that only the fast changing bins will need a lot of - * writes to disk. The more static bins will also be better cacheable with - * MySQL's query cache. + * - we try to put fast changing cache items and rather static ones into + * different bins. The effect is that only the fast changing bins will need a + * lot of writes to disk. The more static bins will also be better cacheable + * with MySQL's query cache. * * @param $cid * The cache ID of the data to store. @@ -188,21 +190,22 @@ /** * Interface for cache implementations. * - * All cache implementations have to implement this interface. DrupalDatabaseCache - * provides the default implementation, which can be consulted as an example. + * All cache implementations have to implement this interface. + * DrupalDatabaseCache provides the default implementation, which can be + * consulted as an example. * * To make Drupal use your implementation for a certain cache bin, you have to - * set a variable with the name of the cache bin as its key and the name of your - * class as its value. For example, if your implementation of DrupalCacheInterface - * was called MyCustomCache, the following line would make Drupal use it for the - * 'cache_page' bin: + * set a variable with the name of the cache bin as its key and the name of + * your class as its value. For example, if your implementation of + * DrupalCacheInterface was called MyCustomCache, the following line would make + * Drupal use it for the 'cache_page' bin: * @code * variable_set('cache_page', 'MyCustomCache'); * @endcode * - * Additionally, you can register your cache implementation to be used by default - * for all cache bins by setting the variable 'cache_default_class' to the name - * of your implementation of the DrupalCacheInterface, e.g. + * Additionally, you can register your cache implementation to be used by + * default for all cache bins by setting the variable 'cache_default_class' to + * the name of your implementation of the DrupalCacheInterface, e.g. * @code * variable_set('cache_default_class', 'MyCustomCache'); * @endcode @@ -226,7 +229,8 @@ * * @param $cid * The cache ID of the data to retrieve. - * @return The cache or FALSE on failure. + * @return + * The cache or FALSE on failure. */ function get($cid); Index: includes/bootstrap.inc =================================================================== RCS file: /cvs/drupal/drupal/includes/bootstrap.inc,v retrieving revision 1.335 diff -u -r1.335 bootstrap.inc --- includes/bootstrap.inc 22 Dec 2009 14:47:14 -0000 1.335 +++ includes/bootstrap.inc 23 Dec 2009 00:24:54 -0000 @@ -37,8 +37,9 @@ define('DRUPAL_MINIMUM_PGSQL', '8.3'); /** - * Indicates that the item should never be removed unless explicitly told to - * using cache_clear_all() with a cache ID. + * Indicates that the item should never be removed unless explicitly selected. + * + * The item may be remove using cache_clear_all() with a cache ID. */ define('CACHE_PERMANENT', 0); Index: includes/authorize.inc =================================================================== RCS file: /cvs/drupal/drupal/includes/authorize.inc,v retrieving revision 1.4 diff -u -r1.4 authorize.inc --- includes/authorize.inc 1 Nov 2009 23:02:13 -0000 1.4 +++ includes/authorize.inc 23 Dec 2009 00:24:54 -0000 @@ -19,7 +19,7 @@ // CSS we depend on lives in modules/system/maintenance.css, which is loaded // via the default maintenance theme. $form['#attached']['js'][] = $base_url . '/misc/authorize.js'; - + // Get all the available ways to transfer files. if (empty($_SESSION['authorize_filetransfer_backends'])) { drupal_set_message(t('Unable to continue, no available methods of file transfer'), 'error'); @@ -182,7 +182,7 @@ variable_set('authorize_filetransfer_connection_settings_' . $filetransfer_backend, $connection_settings); $filetransfer = authorize_get_filetransfer($filetransfer_backend, $form_state['values']['connection_settings'][$filetransfer_backend]); - + // Now run the operation. authorize_run_operation($filetransfer); } Index: includes/ajax.inc =================================================================== RCS file: /cvs/drupal/drupal/includes/ajax.inc,v retrieving revision 1.19 diff -u -r1.19 ajax.inc --- includes/ajax.inc 22 Nov 2009 02:48:37 -0000 1.19 +++ includes/ajax.inc 23 Dec 2009 00:24:54 -0000 @@ -328,7 +328,7 @@ } elseif (is_array($page_callback_result) && isset($page_callback_result['#type']) && ($page_callback_result['#type'] == 'ajax_commands')) { // Complex AJAX callbacks can return a result that contains a specific - // set of commands to send to the browser. + // set of commands to send to the browser. if (isset($page_callback_result['#ajax_commands'])) { $commands = $page_callback_result['#ajax_commands']; } @@ -792,7 +792,7 @@ * The name or key (in the key value pair) of the data attached to this * selector. * @param $value - * The value of the data. Not just limited to strings can be any format. + * The value of the data. Not just limited to strings can be any format. * * @return * An array suitable for use with the ajax_render() function.