#207569 by ScoutBaker (minor code style): clean up @see usage in phpdoc blocks

30 files changed, 120 insertions, 120 deletions

diff --git a/includes/bootstrap.inc b/includes/bootstrap.inc
index caf23b672..4616ce72d 100644
--- a/includes/bootstrap.inc
+++ b/includes/bootstrap.inc
@@ -37,8 +37,8 @@ define('CACHE_AGGRESSIVE', 2);
 /**
  *
  * Severity levels, as defined in RFC 3164 http://www.faqs.org/rfcs/rfc3164.html
- * @see watchdog
- * @see watchdog_severity_levels
+ * @see watchdog()
+ * @see watchdog_severity_levels()
  */
 define('WATCHDOG_EMERG',    0); // Emergency: system is unusable
 define('WATCHDOG_ALERT',    1); // Alert: action must be taken immediately
@@ -562,7 +562,7 @@ function drupal_load($type, $name) {
  * fetch a fresh page on every request.  This prevents authenticated
  * users seeing locally cached pages that show them as logged out.
  *
- * @see page_set_cache
+ * @see page_set_cache()
  */
 function drupal_page_header() {
   header("Expires: Sun, 19 Nov 1978 05:00:00 GMT");
@@ -712,7 +712,7 @@ function request_uri() {
  * @param $link
  *   A link to associate with the message.
  *
- * @see watchdog_severity_levels
+ * @see watchdog_severity_levels()
  */
 function watchdog($type, $message, $variables = array(), $severity = WATCHDOG_NOTICE, $link = NULL) {
   global $user, $base_root;
diff --git a/includes/database.inc b/includes/database.inc
index 25aadf57a..c8212c16f 100644
--- a/includes/database.inc
+++ b/includes/database.inc
@@ -9,7 +9,7 @@
 /**
  * A hash value to check when outputting database errors, md5('DB_ERROR').
  *
- * @see drupal_error_handler
+ * @see drupal_error_handler()
  */
 define('DB_ERROR', 'a515ac9c2796ca0e23adbe92c68fc9fc');
 
diff --git a/modules/aggregator/aggregator.admin.inc b/modules/aggregator/aggregator.admin.inc
index 97733374e..9d78e5491 100644
--- a/modules/aggregator/aggregator.admin.inc
+++ b/modules/aggregator/aggregator.admin.inc
@@ -49,8 +49,8 @@ function aggregator_view() {
  * Form builder; Generate a form to add/edit feed sources.
  *
  * @ingroup forms
- * @see aggregator_form_feed_validate().
- * @see aggregator_form_feed_submit().
+ * @see aggregator_form_feed_validate()
+ * @see aggregator_form_feed_submit()
  */
 function aggregator_form_feed(&$form_state, $edit = array('refresh' => 900, 'title' => '', 'url' => '', 'fid' => NULL)) {
   $period = drupal_map_assoc(array(900, 1800, 3600, 7200, 10800, 21600, 32400, 43200, 64800, 86400, 172800, 259200, 604800, 1209600, 2419200), 'format_interval');
@@ -202,7 +202,7 @@ function aggregator_admin_refresh_feed($feed) {
  * Form builder; Configure the aggregator system.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function aggregator_admin_settings() {
   $items = array(0 => t('none')) + drupal_map_assoc(array(3, 5, 10, 15, 20, 25), '_aggregator_items');
@@ -239,8 +239,8 @@ function aggregator_admin_settings() {
  * Form builder; Generate a form to add/edit/delete aggregator categories.
  *
  * @ingroup forms
- * @see aggregator_form_category_validate().
- * @see aggregator_form_category_submit().
+ * @see aggregator_form_category_validate()
+ * @see aggregator_form_category_submit()
  */
 function aggregator_form_category(&$form_state, $edit = array('title' => '', 'description' => '', 'cid' => NULL)) {
   $form['title'] = array('#type' => 'textfield',
diff --git a/modules/aggregator/aggregator.pages.inc b/modules/aggregator/aggregator.pages.inc
index d15b52d56..2e90379bd 100644
--- a/modules/aggregator/aggregator.pages.inc
+++ b/modules/aggregator/aggregator.pages.inc
@@ -138,8 +138,8 @@ function _aggregator_page_list($items, $op, $feed_source = '') {
  * @return
  *   The form structure.
  * @ingroup forms
- * @see aggregator_categorize_items_validate().
- * @see aggregator_categorize_items_submit().
+ * @see aggregator_categorize_items_validate()
+ * @see aggregator_categorize_items_submit()
  */
 function aggregator_categorize_items($items, $feed_source = '') {
   $form['#submit'][] = 'aggregator_categorize_items_submit';
diff --git a/modules/book/book.admin.inc b/modules/book/book.admin.inc
index 1fddfec4e..ed53c6926 100644
--- a/modules/book/book.admin.inc
+++ b/modules/book/book.admin.inc
@@ -187,7 +187,7 @@ function _book_admin_table_tree($tree, &$form) {
  * Theme function for the book administration page form.
  *
  * @ingroup themeable
- * @see book_admin_table().
+ * @see book_admin_table()
  */
 function theme_book_admin_table($form) {
   drupal_add_tabledrag('book-outline', 'match', 'parent', 'book-plid', 'book-plid', 'book-mlid', TRUE, MENU_MAX_DEPTH - 2);
diff --git a/modules/book/book.module b/modules/book/book.module
index c9215e191..4f603e8f9 100644
--- a/modules/book/book.module
+++ b/modules/book/book.module
@@ -925,7 +925,7 @@ function book_export_traverse($tree, $visit_func) {
 /**
  * Generates printer-friendly HTML for a node.
  *
- * @see book_export_traverse().
+ * @see book_export_traverse()
  *
  * @param $node
  *   The node to generate output for.
diff --git a/modules/comment/comment.admin.inc b/modules/comment/comment.admin.inc
index cdf126435..fb8a5f66c 100644
--- a/modules/comment/comment.admin.inc
+++ b/modules/comment/comment.admin.inc
@@ -30,9 +30,9 @@ function comment_admin($type = 'new') {
  * @return
  *   The form structure.
  * @ingroup forms
- * @see comment_admin_overview_validate().
- * @see comment_admin_overview_submit().
- * @see theme_comment_admin_overview().
+ * @see comment_admin_overview_validate()
+ * @see comment_admin_overview_submit()
+ * @see theme_comment_admin_overview()
  */
 function comment_admin_overview($type = 'new', $arg) {
   // build an 'Update options' form
@@ -161,7 +161,7 @@ function theme_comment_admin_overview($form) {
  * @return
  *   TRUE if the comments should be deleted, FALSE otherwise.
  * @ingroup forms
- * @see comment_multiple_delete_confirm_submit().
+ * @see comment_multiple_delete_confirm_submit()
  */
 function comment_multiple_delete_confirm(&$form_state) {
   $edit = $form_state['post'];
@@ -235,7 +235,7 @@ function comment_delete($cid = NULL) {
  * Form builder; Builds the confirmation form for deleting a single comment.
  *
  * @ingroup forms
- * @see comment_confirm_delete_submit().
+ * @see comment_confirm_delete_submit()
  */
 function comment_confirm_delete(&$form_state, $comment) {
   $form = array();
diff --git a/modules/comment/comment.module b/modules/comment/comment.module
index 4c00cf191..2cc44455c 100644
--- a/modules/comment/comment.module
+++ b/modules/comment/comment.module
@@ -1234,8 +1234,8 @@ function comment_validate($edit) {
  * @param $title
  *   Not used.
  * @ingroup forms
- * @see comment_form_validate().
- * @see comment_form_submit().
+ * @see comment_form_validate()
+ * @see comment_form_submit()
  */
 function comment_form(&$form_state, $edit, $title = NULL) {
   global $user;
diff --git a/modules/dblog/dblog.admin.inc b/modules/dblog/dblog.admin.inc
index ebd8ffd08..2c5924bb5 100644
--- a/modules/dblog/dblog.admin.inc
+++ b/modules/dblog/dblog.admin.inc
@@ -10,7 +10,7 @@
  * dblog module settings form.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function dblog_admin_settings() {
   $form['dblog_row_limit'] = array(
@@ -247,8 +247,8 @@ function _dblog_format_message($dblog) {
  * Return form for dblog administration filters.
  *
  * @ingroup forms
- * @see dblog_filter_form_submit().
- * @see dblog_filter_form_validate().
+ * @see dblog_filter_form_submit()
+ * @see dblog_filter_form_validate()
  */
 function dblog_filter_form() {
   $session = &$_SESSION['dblog_overview_filter'];
diff --git a/modules/dblog/dblog.module b/modules/dblog/dblog.module
index de7805120..0dffb75db 100644
--- a/modules/dblog/dblog.module
+++ b/modules/dblog/dblog.module
@@ -9,7 +9,7 @@
  * recorded events containing usage and performance data, errors,
  * warnings, and similar operational information.
  *
- * @see watchdog().
+ * @see watchdog()
  */
 
 /**
diff --git a/modules/filter/filter.admin.inc b/modules/filter/filter.admin.inc
index 03b98be7b..e98c4ab18 100644
--- a/modules/filter/filter.admin.inc
+++ b/modules/filter/filter.admin.inc
@@ -11,7 +11,7 @@
  * one is the default.
  *
  * @ingroup forms
- * @see filter_admin_overview_submit().
+ * @see filter_admin_overview_submit()
  */
 function filter_admin_overview() {
 
@@ -88,8 +88,8 @@ function filter_admin_format_page($format = NULL) {
  * Generate a filter format form.
  *
  * @ingroup forms
- * @see filter_admin_format_form_validate().
- * @see filter_admin_format_form_submit().
+ * @see filter_admin_format_form_validate()
+ * @see filter_admin_format_form_submit()
  */
 function filter_admin_format_form(&$form_state, $format) {
   $default = ($format->format == variable_get('filter_default_format', 1));
@@ -238,7 +238,7 @@ function filter_admin_format_form_submit($form, &$form_state) {
  * Menu callback; confirm deletion of a format.
  *
  * @ingroup forms
- * @see filter_admin_delete_submit().
+ * @see filter_admin_delete_submit()
  */
 function filter_admin_delete() {
   $format = arg(4);
@@ -335,8 +335,8 @@ function filter_admin_order_page($format) {
  * Build the form for ordering filters for a format.
  *
  * @ingroup forms
- * @see theme_filter_admin_order().
- * @see filter_admin_order_submit().
+ * @see theme_filter_admin_order()
+ * @see filter_admin_order_submit()
  */
 function filter_admin_order(&$form_state, $format = NULL) {
   // Get list (with forced refresh).
diff --git a/modules/filter/filter.module b/modules/filter/filter.module
index ed3eddcb2..3d1e2ccaa 100644
--- a/modules/filter/filter.module
+++ b/modules/filter/filter.module
@@ -462,7 +462,7 @@ function check_markup($text, $format = FILTER_FORMAT_DEFAULT, $check = TRUE) {
  * Generate a selector for choosing a format in a form.
  *
  * @ingroup forms
- * @see filter_form_validate().
+ * @see filter_form_validate()
  * @param $value
  *   The ID of the format that is currently selected.
  * @param $weight
diff --git a/modules/forum/forum.admin.inc b/modules/forum/forum.admin.inc
index 917d4b974..2822e4a52 100644
--- a/modules/forum/forum.admin.inc
+++ b/modules/forum/forum.admin.inc
@@ -25,7 +25,7 @@ function forum_form_main($type, $edit = array()) {
  *
  * @param $edit Associative array containing a forum term to be added or edited.
  * @ingroup forms
- * @see forum_form_submit().
+ * @see forum_form_submit()
  */
 function forum_form_forum(&$form_state, $edit = array()) {
   $edit += array(
@@ -102,7 +102,7 @@ function forum_form_submit($form, &$form_state) {
  *
  * @param $edit Associative array containing a container term to be added or edited.
  * @ingroup forms
- * @see forum_form_submit().
+ * @see forum_form_submit()
  */
 function forum_form_container(&$form_state, $edit = array()) {
   $edit += array(
@@ -183,7 +183,7 @@ function forum_confirm_delete_submit($form, &$form_state) {
 /**
  * Form builder for the forum settings page.
  *
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function forum_admin_settings() {
   $form = array();
diff --git a/modules/forum/forum.module b/modules/forum/forum.module
index 10b7a098b..13ee02bd8 100644
--- a/modules/forum/forum.module
+++ b/modules/forum/forum.module
@@ -876,7 +876,7 @@ function template_preprocess_forum_icon(&$variables) {
  * $variables contains $node.
  *
  * @see forum-topic-navigation.tpl.php
- * @see theme_forum_topic_navigation
+ * @see theme_forum_topic_navigation()
  */
 function template_preprocess_forum_topic_navigation(&$variables) {
   $output = '';
@@ -911,7 +911,7 @@ function template_preprocess_forum_topic_navigation(&$variables) {
  * $variables will contain: $topic
  *
  * @see forum-submitted.tpl.php
- * @see theme_forum_submitted
+ * @see theme_forum_submitted()
  */
 function template_preprocess_forum_submitted(&$variables) {
   $variables['author'] = isset($variables['topic']->uid) ? theme('username', $variables['topic']) : '';
diff --git a/modules/node/node.module b/modules/node/node.module
index 1e6bcc8d6..3f9a4062d 100644
--- a/modules/node/node.module
+++ b/modules/node/node.module
@@ -2206,7 +2206,7 @@ function node_access_needs_rebuild($rebuild = NULL) {
  * Note : As of Drupal 6, node access modules are not required to (and actually
  * should not) call node_access_rebuild() in hook_enable/disable anymore.
  *
- * @see node_access_needs_rebuild
+ * @see node_access_needs_rebuild()
  *
  * @param $batch_mode
  *   Set to TRUE to process in 'batch' mode, spawning processing over several
diff --git a/modules/openid/openid.pages.inc b/modules/openid/openid.pages.inc
index afdf10f05..1dcfe04b7 100644
--- a/modules/openid/openid.pages.inc
+++ b/modules/openid/openid.pages.inc
@@ -55,7 +55,7 @@ function openid_user_identities($account) {
  * Form builder; Add an OpenID identity.
  *
  * @ingroup forms
- * @see openid_user_add_validate().
+ * @see openid_user_add_validate()
  */
 function openid_user_add() {
   $form['openid_url'] = array(
diff --git a/modules/path/path.admin.inc b/modules/path/path.admin.inc
index 71488639d..e5966b3da 100644
--- a/modules/path/path.admin.inc
+++ b/modules/path/path.admin.inc
@@ -81,8 +81,8 @@ function path_admin_edit($pid = 0) {
  * Return a form for editing or creating an individual URL alias.
  *
  * @ingroup forms
- * @see path_admin_form_validate().
- * @see path_admin_form_submit().
+ * @see path_admin_form_validate()
+ * @see path_admin_form_submit()
  */
 function path_admin_form(&$form_state, $edit = array('src' => '', 'dst' => '', 'language' => '', 'pid' => NULL)) {
 
@@ -186,7 +186,7 @@ function path_admin_delete_confirm_submit($form, &$form_state) {
  * Return a form to filter URL aliases.
  *
  * @ingroup forms
- * @see path_admin_filter_form_submit().
+ * @see path_admin_filter_form_submit()
  */
 function path_admin_filter_form(&$form_state, $keys = '') {
   $form['#attributes'] = array('class' => 'search-form');
diff --git a/modules/profile/profile.admin.inc b/modules/profile/profile.admin.inc
index 84e3a774d..e4ceb53c0 100644
--- a/modules/profile/profile.admin.inc
+++ b/modules/profile/profile.admin.inc
@@ -10,7 +10,7 @@
  * Form builder to display a listing of all editable profile fields.
  *
  * @ingroup forms
- * @see profile_admin_overview_submit().
+ * @see profile_admin_overview_submit()
  */
 function profile_admin_overview() {
   $result = db_query('SELECT title, name, type, category, fid, weight FROM {profile_fields} ORDER BY category, weight');
@@ -66,7 +66,7 @@ function profile_admin_overview() {
 /**
  * Submit hanlder to update changed profile field weights and categories.
  *
- * @see profile_admin_overview().
+ * @see profile_admin_overview()
  */
 function profile_admin_overview_submit($form, &$form_state) {
   foreach (element_children($form_state['values']) as $fid) {
@@ -88,7 +88,7 @@ function profile_admin_overview_submit($form, &$form_state) {
  * Theme the profile field overview into a drag and drop enabled table.
  *
  * @ingroup themeable
- * @see profile_admin_overview().
+ * @see profile_admin_overview()
  */
 function theme_profile_admin_overview($form) {
   drupal_add_css(drupal_get_path('module', 'profile') .'/profile.css');
@@ -161,8 +161,8 @@ function theme_profile_admin_overview($form) {
  * Menu callback: Generate a form to add/edit a user profile field.
  *
  * @ingroup forms
- * @see profile_field_form_validate().
- * @see profile_field_form_submit().
+ * @see profile_field_form_validate()
+ * @see profile_field_form_submit()
  */
 function profile_field_form(&$form_state, $arg = NULL) {
   if (arg(3) == 'edit') {
diff --git a/modules/search/search.admin.inc b/modules/search/search.admin.inc
index 2b8726ec3..6e57c653e 100644
--- a/modules/search/search.admin.inc
+++ b/modules/search/search.admin.inc
@@ -30,8 +30,8 @@ function search_wipe_confirm_submit(&$form, &$form_state) {
  * Menu callback; displays the search module settings page.
  *
  * @ingroup forms
- * @see system_settings_form().
- * @see search_admin_settings_validate().
+ * @see system_settings_form()
+ * @see search_admin_settings_validate()
  */
 function search_admin_settings() {
   // Collect some stats
diff --git a/modules/search/search.module b/modules/search/search.module
index 335aafbf2..56bb1baa8 100644
--- a/modules/search/search.module
+++ b/modules/search/search.module
@@ -1049,8 +1049,8 @@ function search_form(&$form_state, $action = '', $keys = '', $type = NULL, $prom
  * Form builder; Output a search form for the search block and the theme's search box.
  *
  * @ingroup forms
- * @see search_box_form_submit().
- * @see theme_search_box_form().
+ * @see search_box_form_submit()
+ * @see theme_search_box_form()
  */
 function search_box(&$form_state, $form_id) {
   $form[$form_id] = array(
diff --git a/modules/statistics/statistics.admin.inc b/modules/statistics/statistics.admin.inc
index a8a6b59ad..e41403c59 100644
--- a/modules/statistics/statistics.admin.inc
+++ b/modules/statistics/statistics.admin.inc
@@ -178,7 +178,7 @@ function statistics_access_log($aid) {
  * Form builder; Configure access logging.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function statistics_access_logging_settings() {
   // Access log settings:
diff --git a/modules/system/system.admin.inc b/modules/system/system.admin.inc
index 027f9b0f6..a355a7fa7 100644
--- a/modules/system/system.admin.inc
+++ b/modules/system/system.admin.inc
@@ -148,7 +148,7 @@ function system_settings_overview() {
  * Form builder; This function allows selection of the theme to show in administration sections.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function system_admin_theme_settings() {
   $themes = system_theme_data();
@@ -181,7 +181,7 @@ function system_admin_theme_settings() {
  * Menu callback; displays a listing of all themes.
  *
  * @ingroup forms
- * @see system_themes_form_submit().
+ * @see system_themes_form_submit()
  */
 function system_themes_form() {
 
@@ -318,7 +318,7 @@ function system_themes_form_submit($form, &$form_state) {
  * @return
  *   The form structure.
  * @ingroup forms
- * @see system_theme_settings_submit().
+ * @see system_theme_settings_submit()
  */
 function system_theme_settings(&$form_state, $key = '') {
   $directory_path = file_directory_path();
@@ -600,8 +600,8 @@ function _system_is_incompatible(&$incompatible, $files, $file) {
  * @param $form_state
  *   An associative array containing the current state of the form.
  * @ingroup forms
- * @see theme_system_modules().
- * @see system_modules_submit().
+ * @see theme_system_modules()
+ * @see system_modules_submit()
  * @return
  *   The form array.
  */
@@ -978,8 +978,8 @@ function system_module_build_dependencies($modules, $form_values) {
  * Builds a form of currently disabled modules.
  *
  * @ingroup forms
- * @see system_modules_uninstall_validate().
- * @see system_modules_uninstall_submit().
+ * @see system_modules_uninstall_validate()
+ * @see system_modules_uninstall_submit()
  * @param $form_state['values']
  *   Submitted form values.
  * @return
@@ -1109,7 +1109,7 @@ function system_modules_uninstall_submit($form, &$form_state) {
  * Form builder; The general site information form.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function system_site_information_settings() {
   $form['site_name'] = array(
@@ -1189,7 +1189,7 @@ function system_site_information_settings_validate($form, &$form_state) {
  * Form builder; Configure error reporting settings.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function system_error_reporting_settings() {
 
@@ -1253,7 +1253,7 @@ function system_logging_overview() {
  * Form builder; Configure site performance settings.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function system_performance_settings() {
 
@@ -1371,7 +1371,7 @@ function system_clear_cache_submit(&$form_state, $form) {
  * Form builder; Configure the site file handling.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function system_file_system_settings() {
 
@@ -1408,7 +1408,7 @@ function system_file_system_settings() {
  * Form builder; Configure site image toolkit usage.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function system_image_toolkit_settings() {
   $toolkits_available = image_get_available_toolkits();
@@ -1445,7 +1445,7 @@ function system_image_toolkit_settings_validate($form, &$form_state) {
  * Form builder; Configure how the site handles RSS feeds.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function system_rss_feeds_settings() {
 
@@ -1471,8 +1471,8 @@ function system_rss_feeds_settings() {
  * Form builder; Configure the site date and time settings.
  *
  * @ingroup forms
- * @see system_settings_form().
- * @see system_date_time_settings_submit().
+ * @see system_settings_form()
+ * @see system_date_time_settings_submit()
  */
 function system_date_time_settings() {
   drupal_add_js(drupal_get_path('module', 'system') .'/system.js', 'module');
@@ -1644,7 +1644,7 @@ function system_date_time_lookup() {
  * Form builder; Configure the site's maintenance status.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function system_site_maintenance_settings() {
 
@@ -1670,7 +1670,7 @@ function system_site_maintenance_settings() {
  * Form builder; Configure Clean URL settings.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function system_clean_url_settings() {
   $form['clean_url'] = array(
diff --git a/modules/system/system.module b/modules/system/system.module
index 2b962c7b0..f6b4409ad 100644
--- a/modules/system/system.module
+++ b/modules/system/system.module
@@ -460,7 +460,7 @@ function system_menu() {
     'type' => MENU_CALLBACK,
   );
   // Menu handler to test that drupal_http_request() works locally.
-  // @see system_check_http_request().
+  // @see system_check_http_request()
   $items['admin/reports/request-test'] = array(
     'title' => 'Request test',
     'page callback' => 'printf',
@@ -1009,7 +1009,7 @@ function system_initialize_theme_blocks($theme) {
  * Add default buttons to a form and set its prefix.
  *
  * @ingroup forms
- * @see system_settings_form_submit
+ * @see system_settings_form_submit()
  * @param $form
  *   An associative array containing the structure of the form.
  * @return
@@ -1344,7 +1344,7 @@ function system_actions_manage() {
 /**
  * Define the form for the actions overview page.
  *
- * @see system_actions_manage_form_submit
+ * @see system_actions_manage_form_submit()
  * @ingroup forms
  * @param $form_state
  *   An associative array containing the current state of the form; not used.
@@ -1500,7 +1500,7 @@ function system_actions_configure_submit($form, &$form_state) {
  * Create the form for confirmation of deleting an action.
  *
  * @ingroup forms
- * @see system_actions_delete_form_submit
+ * @see system_actions_delete_form_submit()
  */
 function system_actions_delete_form($form_state, $action) {
 
diff --git a/modules/taxonomy/taxonomy.admin.inc b/modules/taxonomy/taxonomy.admin.inc
index 80fa47044..cf90aaacf 100644
--- a/modules/taxonomy/taxonomy.admin.inc
+++ b/modules/taxonomy/taxonomy.admin.inc
@@ -10,8 +10,8 @@
  * Form builder to list and manage vocabularies.
  *
  * @ingroup forms
- * @see taxonomy_overview_vocabularies_submit().
- * @see theme_taxonomy_overview_vocabularies().
+ * @see taxonomy_overview_vocabularies_submit()
+ * @see theme_taxonomy_overview_vocabularies()
  */
 function taxonomy_overview_vocabularies() {
   $vocabularies = taxonomy_get_vocabularies();
@@ -45,7 +45,7 @@ function taxonomy_overview_vocabularies() {
 /**
  * Submit handler for vocabularies overview. Updates changed vocabulary weights.
  *
- * @see taxonomy_overview_vocabularies().
+ * @see taxonomy_overview_vocabularies()
  */
 function taxonomy_overview_vocabularies_submit($form, &$form_state) {
   foreach ($form_state['values'] as $vid => $vocabulary) {
@@ -60,7 +60,7 @@ function taxonomy_overview_vocabularies_submit($form, &$form_state) {
  * Theme the vocabulary overview as a sortable list of vocabularies.
  *
  * @ingroup themeable
- * @see taxonomy_overview_vocabularies().
+ * @see taxonomy_overview_vocabularies()
  */
 function theme_taxonomy_overview_vocabularies($form) {
   $rows = array();
@@ -98,7 +98,7 @@ function theme_taxonomy_overview_vocabularies($form) {
  * Display form for adding and editing vocabularies.
  *
  * @ingroup forms
- * @see taxonomy_form_vocabulary_submit().
+ * @see taxonomy_form_vocabulary_submit()
  */
 function taxonomy_form_vocabulary(&$form_state, $edit = array()) {
   $edit += array(
@@ -240,8 +240,8 @@ function taxonomy_admin_term_edit($tid) {
  * each one. The form is made drag and drop by the theme function.
  *
  * @ingroup forms
- * @see taxonomy_overview_terms_submit().
- * @see theme_taxonomy_overview_terms().
+ * @see taxonomy_overview_terms_submit()
+ * @see theme_taxonomy_overview_terms()
  */
 function taxonomy_overview_terms(&$form_state, $vocabulary) {
   global $pager_page_array, $pager_total, $pager_total_items;
@@ -439,7 +439,7 @@ function taxonomy_overview_terms(&$form_state, $vocabulary) {
  * when a term has children so that reordering is minimal when a child is
  * added or removed from a term.
  *
- * @see taxonomy_overview_terms().
+ * @see taxonomy_overview_terms()
  */
 function taxonomy_overview_terms_submit($form, &$form_state) {
   if ($form_state['clicked_button']['#value'] == t('Reset to alphabetical')) {
@@ -535,7 +535,7 @@ function taxonomy_overview_terms_submit($form, &$form_state) {
  * Theme the terms overview as a sortable list of terms.
  *
  * @ingroup themeable
- * @see taxonomy_overview_terms().
+ * @see taxonomy_overview_terms()
  */
 function theme_taxonomy_overview_terms($form) {
   $page_increment  = $form['#page_increment'];
@@ -629,7 +629,7 @@ function taxonomy_add_term_page($vocabulary) {
  * Form function for the term edit form.
  *
  * @ingroup forms
- * @see taxonomy_form_term_submit().
+ * @see taxonomy_form_term_submit()
  */
 function taxonomy_form_term(&$form_state, $vocabulary, $edit = array()) {
   $edit += array(
@@ -732,7 +732,7 @@ function taxonomy_form_term(&$form_state, $vocabulary, $edit = array()) {
 /**
  * Validation handler for the term edit form. Ensure numeric weight values.
  *
- * @see taxonomy_form_term().
+ * @see taxonomy_form_term()
  */
 function taxonomy_form_term_validate($form, &$form_state) {
   if (isset($form_state['values']['weight']) && !is_numeric($form_state['values']['weight'])) {
@@ -743,7 +743,7 @@ function taxonomy_form_term_validate($form, &$form_state) {
 /**
  * Submit handler to insert or update a term.
  *
- * @see taxonomy_form_term().
+ * @see taxonomy_form_term()
  */
 function taxonomy_form_term_submit($form, &$form_state) {
   if ($form_state['clicked_button']['#value'] == t('Delete')) {
@@ -805,7 +805,7 @@ function taxonomy_form_term_submit($form, &$form_state) {
  * Form builder for the confirmation of multiple term parents.
  *
  * @ingroup forms
- * @see taxonomy_form_term().
+ * @see taxonomy_form_term()
  */
 function taxonomy_term_confirm_parents(&$form_state, $vocabulary) {
   $form = array();
@@ -825,7 +825,7 @@ function taxonomy_term_confirm_parents(&$form_state, $vocabulary) {
  * Form builder for the term delete form.
  *
  * @ingroup forms
- * @see taxonomy_term_confirm_delete_submit().
+ * @see taxonomy_term_confirm_delete_submit()
  */
 function taxonomy_term_confirm_delete(&$form_state, $tid) {
   $term = taxonomy_get_term($tid);
@@ -846,7 +846,7 @@ function taxonomy_term_confirm_delete(&$form_state, $tid) {
 /**
  * Submit handler to delete a term after confirmation.
  *
- * @see taxonomy_term_confirm_delete().
+ * @see taxonomy_term_confirm_delete()
  */
 function taxonomy_term_confirm_delete_submit($form, &$form_state) {
   taxonomy_del_term($form_state['values']['tid']);
@@ -861,7 +861,7 @@ function taxonomy_term_confirm_delete_submit($form, &$form_state) {
  * Form builder for the vocabulary delete confirmation form.
  *
  * @ingroup forms
- * @see taxonomy_vocabulary_confirm_delete_submit().
+ * @see taxonomy_vocabulary_confirm_delete_submit()
  */
 function taxonomy_vocabulary_confirm_delete(&$form_state, $vid) {
   $vocabulary = taxonomy_vocabulary_load($vid);
@@ -881,7 +881,7 @@ function taxonomy_vocabulary_confirm_delete(&$form_state, $vid) {
 /**
  * Submit handler to delete a vocabulary after confirmation.
  *
- * @see taxonomy_vocabulary_confirm_delete().
+ * @see taxonomy_vocabulary_confirm_delete()
  */
 function taxonomy_vocabulary_confirm_delete_submit($form, &$form_state) {
   $status = taxonomy_del_vocabulary($form_state['values']['vid']);
@@ -895,7 +895,7 @@ function taxonomy_vocabulary_confirm_delete_submit($form, &$form_state) {
  * Form builder to confirm reseting a vocabulary to alphabetical order.
  *
  * @ingroup forms
- * @see taxonomy_vocabulary_confirm_reset_alphabetical_submit().
+ * @see taxonomy_vocabulary_confirm_reset_alphabetical_submit()
  */
 function taxonomy_vocabulary_confirm_reset_alphabetical(&$form_state, $vid) {
   $vocabulary = taxonomy_vocabulary_load($vid);
@@ -916,7 +916,7 @@ function taxonomy_vocabulary_confirm_reset_alphabetical(&$form_state, $vid) {
 /**
  * Submit handler to reset a vocabulary to alphabetical order after confirmation.
  *
- * @see taxonomy_vocabulary_confirm_reset_alphabetical().
+ * @see taxonomy_vocabulary_confirm_reset_alphabetical()
  */
 function taxonomy_vocabulary_confirm_reset_alphabetical_submit($form, &$form_state) {
   db_query('UPDATE {term_data} t SET weight = 0 WHERE vid = %d', $form_state['values']['vid']);
diff --git a/modules/throttle/throttle.admin.inc b/modules/throttle/throttle.admin.inc
index 75ad7cd95..86fc51f52 100644
--- a/modules/throttle/throttle.admin.inc
+++ b/modules/throttle/throttle.admin.inc
@@ -10,8 +10,8 @@
  * Form builder; Configure the throttle system.
  *
  * @ingroup forms
- * @see system_settings_form().
- * @see throttle_admin_settings_validate().
+ * @see system_settings_form()
+ * @see throttle_admin_settings_validate()
  */
 function throttle_admin_settings() {
   $probabilities = array(0 => '100%', 1 => '50%', 2 => '33.3%', 3 => '25%', 4 => '20%', 5 => '16.6%', 7 => '12.5%', 9 => '10%', 19 => '5%', 99 => '1%', 199 => '.5%', 399 => '.25%', 989 => '.1%');
diff --git a/modules/trigger/trigger.admin.inc b/modules/trigger/trigger.admin.inc
index 7f9f3266c..217bfd5c3 100644
--- a/modules/trigger/trigger.admin.inc
+++ b/modules/trigger/trigger.admin.inc
@@ -45,7 +45,7 @@ function trigger_assign($type = NULL) {
  * @param $aid
  *   The action ID.
  * @ingroup forms
- * @see trigger_unassign_submit().
+ * @see trigger_unassign_submit()
  */
 function trigger_unassign($form_state, $hook = NULL, $op = NULL, $aid = NULL) {
   if (!($hook && $op && $aid)) {
diff --git a/modules/update/update.module b/modules/update/update.module
index 51733078b..1745d00fe 100644
--- a/modules/update/update.module
+++ b/modules/update/update.module
@@ -329,9 +329,9 @@ function update_refresh() {
  *   as the keys, and the status reason constant (UPDATE_NOT_SECURE, etc) for
  *   the values.
  *
- * @see drupal_mail();
- * @see _update_cron_notify();
- * @see _update_message_text();
+ * @see drupal_mail()
+ * @see _update_cron_notify()
+ * @see _update_message_text()
  */
 function update_mail($key, &$message, $params) {
   $language = $message['language'];
diff --git a/modules/user/user.admin.inc b/modules/user/user.admin.inc
index 00607f1da..cda6fbb97 100644
--- a/modules/user/user.admin.inc
+++ b/modules/user/user.admin.inc
@@ -36,7 +36,7 @@ function user_admin($callback_arg = '') {
  * Form builder; Return form for user administration filters.
  *
  * @ingroup forms
- * @see user_filter_form_submit().
+ * @see user_filter_form_submit()
  */
 function user_filter_form() {
   $session = &$_SESSION['user_overview_filter'];
@@ -129,8 +129,8 @@ function user_filter_form_submit($form, &$form_state) {
  * Form builder; User administration page.
  *
  * @ingroup forms
- * @see user_admin_account_validate().
- * @see user_admin_account_submit().
+ * @see user_admin_account_validate()
+ * @see user_admin_account_submit()
  */
 function user_admin_account() {
   $filter = user_build_filter_query();
@@ -232,7 +232,7 @@ function user_admin_account_validate($form, &$form_state) {
  * Form builder; Configure user settings for this site.
  *
  * @ingroup forms
- * @see system_settings_form().
+ * @see system_settings_form()
  */
 function user_admin_settings() {
   // User registration settings.
@@ -495,8 +495,8 @@ function user_admin_settings() {
  * Menu callback: administer permissions.
  *
  * @ingroup forms
- * @see user_admin_perm_submit().
- * @see theme_user_admin_perm().
+ * @see user_admin_perm_submit()
+ * @see theme_user_admin_perm()
  */
 function user_admin_perm($form_state, $rid = NULL) {
   if (is_numeric($rid)) {
@@ -620,9 +620,9 @@ function theme_user_admin_perm($form) {
  * Menu callback: administer roles.
  *
  * @ingroup forms
- * @see user_admin_role_validate().
- * @see user_admin_role_submit().
- * @see theme_user_admin_new_role().
+ * @see user_admin_role_validate()
+ * @see user_admin_role_submit()
+ * @see theme_user_admin_new_role()
  */
 function user_admin_role() {
   $id = arg(4);
@@ -868,7 +868,7 @@ function user_admin_access_check_submit($form, &$form_state) {
  * Menu callback: delete an access rule
  *
  * @ingroup forms
- * @see user_admin_access_delete_confirm_submit().
+ * @see user_admin_access_delete_confirm_submit()
  */
 function user_admin_access_delete_confirm($form_state, $aid = 0) {
   $access_types = array('user' => t('username'), 'mail' => t('e-mail'), 'host' => t('host'));
diff --git a/modules/user/user.module b/modules/user/user.module
index 05556aecd..aca41f838 100644
--- a/modules/user/user.module
+++ b/modules/user/user.module
@@ -1249,9 +1249,9 @@ function user_login(&$form_state, $msg = '') {
  * drupal_form_alter() in drupal.module for an example of altering
  * this series of validators.
  *
- * @see user_login_name_validate().
- * @see user_login_authenticate_validate().
- * @see user_login_final_validate().
+ * @see user_login_name_validate()
+ * @see user_login_authenticate_validate()
+ * @see user_login_final_validate()
  * @return array
  *   A simple list of validate functions.
  */
@@ -2266,8 +2266,8 @@ function user_register_submit($form, &$form_state) {
  * Form builder; The user registration form.
  *
  * @ingroup forms
- * @see user_register_validate().
- * @see user_register_submit().
+ * @see user_register_validate()
+ * @see user_register_submit()
  */
 function user_register() {
   global $user;
diff --git a/modules/user/user.pages.inc b/modules/user/user.pages.inc
index 0887a760e..e2c178136 100644
--- a/modules/user/user.pages.inc
+++ b/modules/user/user.pages.inc
@@ -25,8 +25,8 @@ function user_autocomplete($string = '') {
  * Form builder; Request a password reset.
  *
  * @ingroup forms
- * @see user_pass_validate().
- * @see user_pass_submit().
+ * @see user_pass_validate()
+ * @see user_pass_submit()
  */
 function user_pass() {
   $form['name'] = array(
@@ -214,8 +214,8 @@ function template_preprocess_user_profile_category(&$variables) {
  * Form builder; Present the form to edit a given user or profile category.
  *
  * @ingroup forms
- * @see user_edit_validate().
- * @see user_edit_submit().
+ * @see user_edit_validate()
+ * @see user_edit_submit()
  */
 function user_edit($account, $category = 'account') {
   drupal_set_title(check_plain($account->name));
@@ -227,8 +227,8 @@ function user_edit($account, $category = 'account') {
  *
  * @ingroup forms
  * @see user_profile_form_validate()
- * @see user_profile_form_submit().
- * @see user_edit_delete_submit().
+ * @see user_profile_form_submit()
+ * @see user_edit_delete_submit()
  */
 function user_profile_form($form_state, $account, $category = 'account') {
 
@@ -298,7 +298,7 @@ function user_edit_delete_submit($form, &$form_state) {
  * Form builder; confirm form for user deletion.
  *
  * @ingroup forms
- * @see user_confirm_delete_submit().
+ * @see user_confirm_delete_submit()
  */
 function user_confirm_delete(&$form_state, $account) {