diff --git a/core/modules/system/system.admin.inc b/core/modules/system/system.admin.inc
index 9d5af3f..b194619 100644
--- a/core/modules/system/system.admin.inc
+++ b/core/modules/system/system.admin.inc
@@ -1720,8 +1720,10 @@ function system_clear_page_cache_submit($form, &$form_state) {
 /**
  * Form builder; Configure the site file handling.
  *
- * @ingroup forms
  * @see system_settings_form()
+ * @see system_file_system_settings_validate()
+ * @see system_file_system_settings_submit()
+ * @ingroup forms
  */
 function system_file_system_settings() {
   $form = array(
@@ -1771,8 +1773,9 @@ function system_file_system_settings() {
 }
 
 /**
- * Validates that the private and temporary directories do not resolve to the
- * same directory location as the public directory.
+ * Form validation handler for the system_file_system_settings() form.
+ *
+ * @see system_file_system_settings_submit()
  */
 function system_file_system_settings_validate($form, &$form_state) {
   $resolved_public_path = realpath($form['file_public_path']['#value']);
@@ -1789,8 +1792,11 @@ function system_file_system_settings_validate($form, &$form_state) {
 }
 
 /**
- * Checks that the public, private, and temporary paths exist, or can be created
- * if necessary.
+ * Form submission handler for the system_file_system_settings form.
+ *
+ * Verify public, private, and temporary paths exist, or can be created.
+ *
+ * @see system_file_system_settings_validate()
  */
 function system_file_system_settings_submit($form, &$form_state) {
   system_check_directory($form['file_public_path'], FALSE);
diff --git a/core/modules/system/system.module b/core/modules/system/system.module
index 6c7affc..c4fca0f 100644
--- a/core/modules/system/system.module
+++ b/core/modules/system/system.module
@@ -2664,9 +2664,9 @@ function system_admin_menu_block($item) {
  *
  * @param $form_element
  *   The form element containing the name of the directory to check.
- * @param $private
- *   If $private is TRUE, create an .htaccess file configured for secure access
- *   in the directory specified by $form_element.
+ * @param boolean $private
+ *   (optional) If $private is TRUE, create an .htaccess file configured for
+ *   secure access in the directory specified by $form_element.
  */
 function system_check_directory($form_element, $private = TRUE) {
   $directory = $form_element['#value'];