Index: includes/install.inc =================================================================== RCS file: /cvs/drupal/drupal/includes/install.inc,v retrieving revision 1.136 diff -u -r1.136 install.inc --- includes/install.inc 21 Jun 2010 02:27:47 -0000 1.136 +++ includes/install.inc 15 Jul 2010 20:36:27 -0000 @@ -87,6 +87,7 @@ * * @param $module * A module name. + * * @return * If the module has updates, an array of available updates sorted by version. * Otherwise, FALSE. @@ -135,6 +136,7 @@ * @param $array * Set to TRUE if you want to get information about all modules in the * system. + * * @return * The currently installed schema version, or SCHEMA_UNINSTALLED if the * module is not installed. @@ -207,6 +209,7 @@ * @param $file * The name of the file calling this function so we can strip it out of * the URI when generating the base_url. + * * @return * The auto-detected $base_url that should be configured in settings.php */ @@ -224,7 +227,7 @@ * Detect all supported databases that are compiled into PHP. * * @return - * An array of database types compiled into PHP. + * An array of database types compiled into PHP. */ function drupal_detect_database_types() { $databases = array(); @@ -503,6 +506,7 @@ * * @param $install_state * An array of information about the current installation state. + * * @return * The list of modules to install. */ @@ -642,6 +646,7 @@ * An optional bitmask created from various FILE_* constants. * @param $type * The type of file. Can be file (default), dir, or link. + * * @return * TRUE on success or FALSE on failure. A message is set for the latter. */ @@ -716,13 +721,14 @@ * Create a directory with specified permissions. * * @param $file - * The name of the directory to create; + * The name of the directory to create; * @param $mask - * The permissions of the directory to create. + * The permissions of the directory to create. * @param $message - * (optional) Whether to output messages. Defaults to TRUE. + * (optional) Whether to output messages. Defaults to TRUE. + * * @return - * TRUE/FALSE whether or not the directory was successfully created. + * TRUE/FALSE whether or not the directory was successfully created. */ function drupal_install_mkdir($file, $mask, $message = TRUE) { $mod = 0; @@ -764,13 +770,14 @@ * 0700 and get the correct value of 0500. * * @param $file - * The name of the file with permissions to fix. + * The name of the file with permissions to fix. * @param $mask - * The desired permissions for the file. + * The desired permissions for the file. * @param $message - * (optional) Whether to output messages. Defaults to TRUE. + * (optional) Whether to output messages. Defaults to TRUE. + * * @return - * TRUE/FALSE whether or not we were able to fix the file's permissions. + * TRUE/FALSE whether or not we were able to fix the file's permissions. */ function drupal_install_fix_file($file, $mask, $message = TRUE) { // If $file does not exist, fileperms() issues a PHP warning. @@ -905,6 +912,7 @@ * * @param $profile * Name of install profile to check. + * * @return * Array of the install profile's requirements. */ @@ -937,6 +945,7 @@ * @param $requirements * An array of requirements, in the same format as is returned by * hook_requirements(). + * * @return * The highest severity in the array. */ @@ -955,6 +964,7 @@ * * @param $module * Machine name of module to check. + * * @return * TRUE/FALSE depending on the requirements are in place. */ @@ -1007,6 +1017,7 @@ * Name of profile. * @param locale * Name of locale used (if any). + * * @return * The info array. */