Index: modules/book/book.pages.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/book/book.pages.inc,v
retrieving revision 1.24
diff -u -r1.24 book.pages.inc
--- modules/book/book.pages.inc	9 Jan 2010 21:54:00 -0000	1.24
+++ modules/book/book.pages.inc	28 Jan 2010 20:04:42 -0000
@@ -97,10 +97,10 @@
 /**
  * Build the form to handle all book outline operations via the outline tab.
  *
+ * @ingroup forms
+ *
  * @see book_outline_form_submit()
  * @see book_remove_button_submit()
- *
- * @ingroup forms
  */
 function book_outline_form($form, &$form_state, $node) {
   if (!isset($node->book)) {
Index: modules/book/book.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/book/book.module,v
retrieving revision 1.536
diff -u -r1.536 book.module
--- modules/book/book.module	9 Jan 2010 21:54:00 -0000	1.536
+++ modules/book/book.module	28 Jan 2010 20:04:42 -0000
@@ -1110,14 +1110,14 @@
 /**
  * Generates printer-friendly HTML for a node.
  *
- * @see book_export_traverse()
- *
  * @param $node
  *   The node that will be output.
  * @param $children
  *   All the rendered child nodes within the current node.
  * @return
  *   The HTML generated for the given node.
+ *
+ * @see book_export_traverse()
  */
 function book_node_export($node, $children = '') {
   $build = node_view($node, 'print');
Index: modules/book/book.admin.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/book/book.admin.inc,v
retrieving revision 1.31
diff -u -r1.31 book.admin.inc
--- modules/book/book.admin.inc	9 Jan 2010 21:54:00 -0000	1.31
+++ modules/book/book.admin.inc	28 Jan 2010 20:04:42 -0000
@@ -25,9 +25,9 @@
 /**
  * Builds and returns the book settings form.
  *
- * @see book_admin_settings_validate()
- *
  * @ingroup forms
+ *
+ * @see book_admin_settings_validate()
  */
 function book_admin_settings() {
   $types = node_type_get_names();
@@ -67,9 +67,9 @@
 /**
  * Build the form to administrate the hierarchy of a single book.
  *
- * @see book_admin_edit_submit()
- *
  * @ingroup forms.
+ *
+ * @see book_admin_edit_submit()
  */
 function book_admin_edit($form, $form_state, $node) {
   drupal_set_title($node->title);
@@ -215,6 +215,7 @@
  * Theme function for the book administration page form.
  *
  * @ingroup themeable
+ *
  * @see book_admin_table()
  */
 function theme_book_admin_table($variables) {
Index: modules/profile/profile-listing.tpl.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/profile/profile-listing.tpl.php,v
retrieving revision 1.7
diff -u -r1.7 profile-listing.tpl.php
--- modules/profile/profile-listing.tpl.php	6 Aug 2009 05:05:59 -0000	1.7
+++ modules/profile/profile-listing.tpl.php	28 Jan 2010 20:04:49 -0000
@@ -6,7 +6,7 @@
  * Default theme implementation for displaying a user and their profile data
  * for member listing pages.
  *
- * @see profile-wrapper.tpl.php
+ * See profile-wrapper.tpl.php
  *      where all the data is collected and printed out.
  *
  * Available variables:
Index: includes/password.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/password.inc,v
retrieving revision 1.6
diff -u -r1.6 password.inc
--- includes/password.inc	26 Feb 2009 07:30:26 -0000	1.6
+++ includes/password.inc	28 Jan 2010 20:04:38 -0000
@@ -6,7 +6,7 @@
  * Secure password hashing functions for user authentication.
  *
  * Based on the Portable PHP password hashing framework.
- * @see http://www.openwall.com/phpass/
+ * See http://www.openwall.com/phpass/
  *
  * An alternative or custom version of this password hashing API may be
  * used by setting the variable password_inc to the name of the PHP file
Index: includes/file.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/file.inc,v
retrieving revision 1.202
diff -u -r1.202 file.inc
--- includes/file.inc	26 Jan 2010 08:29:25 -0000	1.202
+++ includes/file.inc	28 Jan 2010 20:04:35 -0000
@@ -315,7 +315,7 @@
  * Creates a web-accessible URL for a stream to an external or local file.
  *
  * Compatibility: normal paths and stream wrappers.
- * @see http://drupal.org/node/515192
+ * See http://drupal.org/node/515192
  *
  * There are two kinds of local files:
  * - "created files", i.e. those in the files directory (which is stored in
@@ -535,7 +535,7 @@
  *   replace the file or rename the file based on the $replace parameter.
  * - Adds the new file to the files database. If the source file is a
  *   temporary file, the resulting file will also be a temporary file.
- *   @see file_save_upload() for details on temporary files.
+ *   see file_save_upload() for details on temporary files.
  *
  * @param $source
  *   A file object.
@@ -1064,7 +1064,7 @@
 function file_space_used($uid = NULL, $status = FILE_STATUS_PERMANENT) {
   $query = db_select('file', 'f');
   // Use separate placeholders for the status to avoid a bug in some versions
-  // of PHP. @see http://drupal.org/node/352956
+  // of PHP. See http://drupal.org/node/352956
   $query->where('f.status & :status1 = :status2', array(':status1' => $status, ':status2' => $status));
   $query->addExpression('SUM(f.filesize)', 'filesize');
   if (!is_null($uid)) {
@@ -1121,7 +1121,7 @@
 
   // Check for file upload errors and return FALSE if a lower level system
   // error occurred. For a complete list of errors:
-  // @see http://php.net/manual/en/features.file-upload.errors.php
+  // see http://php.net/manual/en/features.file-upload.errors.php
   switch ($_FILES['files']['error'][$source]) {
     case UPLOAD_ERR_INI_SIZE:
     case UPLOAD_ERR_FORM_SIZE:
@@ -1728,8 +1728,8 @@
  * @return
  *   The internet media type registered for the extension or
  *   application/octet-stream for unknown extensions.
- * @see
- *   file_default_mimetype_mapping()
+ * 
+ * @see file_default_mimetype_mapping()
  */
 function file_get_mimetype($uri, $mapping = NULL) {
   if ($wrapper = file_stream_wrapper_get_instance_by_uri($uri)) {
@@ -1804,10 +1804,10 @@
  * scheme or the wrapper implementation does not implement realpath, then
  * FALSE will be returned.
  *
- * @see http://php.net/manual/en/function.realpath.php
+ * See http://php.net/manual/en/function.realpath.php
  *
  * Compatibility: normal paths and stream wrappers.
- * @see http://drupal.org/node/515192
+ * See http://drupal.org/node/515192
  *
  * @param $uri
  *   A string containing the URI to verify. If this value is omitted,
@@ -1815,8 +1815,9 @@
  * @return
  *   The absolute pathname, or FALSE on failure.
  *
- * @see realpath()
  * @ingroup php_wrappers
+ *
+ * @see realpath()
  */
 function drupal_realpath($uri) {
   // If this URI is a stream, pass it off to the appropriate stream wrapper.
@@ -1838,15 +1839,16 @@
  * PHP's dirname() as a fallback.
  *
  * Compatibility: normal paths and stream wrappers.
- * @see http://drupal.org/node/515192
+ * See http://drupal.org/node/515192
  *
  * @param $uri
  *   A URI or path.
  * @return
  *   A string containing the directory name.
  *
- * @see dirname()
  * @ingroup php_wrappers
+ *
+ * @see dirname()
  */
 function drupal_dirname($uri) {
   $scheme = file_uri_scheme($uri);
@@ -1873,7 +1875,7 @@
  * is not provided, this function will make sure that Drupal's is used.
  *
  * Compatibility: normal paths and stream wrappers.
- * @see http://drupal.org/node/515192
+ * See http://drupal.org/node/515192
  *
  * @param $uri
  *   A URI or pathname.
@@ -1886,8 +1888,9 @@
  * @return
  *   Boolean TRUE on success, or FALSE on failure.
  *
- * @see mkdir()
  * @ingroup php_wrappers
+ *
+ * @see mkdir()
  */
 function drupal_mkdir($uri, $mode = NULL, $recursive = FALSE, $context = NULL) {
 
@@ -1911,7 +1914,7 @@
  * given a filepath.
  *
  * Compatibility: normal paths and stream wrappers.
- * @see http://drupal.org/node/515192
+ * See http://drupal.org/node/515192
  *
  * @param $directory
  *   The directory where the temporary filename will be created.
@@ -1921,8 +1924,9 @@
  * @return
  *   The new temporary filename, or FALSE on failure.
  *
- * @see tempnam()
  * @ingroup php_wrappers
+ *
+ * @see tempnam()
  */
 function drupal_tempnam($directory, $prefix) {
   $scheme = file_uri_scheme($directory);
Index: includes/bootstrap.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/bootstrap.inc,v
retrieving revision 1.346
diff -u -r1.346 bootstrap.inc
--- includes/bootstrap.inc	25 Jan 2010 10:38:34 -0000	1.346
+++ includes/bootstrap.inc	28 Jan 2010 20:04:30 -0000
@@ -741,7 +741,8 @@
  * @return
  *   The value of the variable.
  *
- * @see variable_del(), variable_set()
+ * @see variable_del()
+ * @see variable_set()
  */
 function variable_get($name, $default = NULL) {
   global $conf;
@@ -758,7 +759,8 @@
  *   The value to set. This can be any PHP data type; these functions take care
  *   of serialization as necessary.
  *
- * @see variable_del(), variable_get()
+ * @see variable_del()
+ * @see variable_get()
  */
 function variable_set($name, $value) {
   global $conf;
@@ -776,7 +778,8 @@
  * @param $name
  *   The name of the variable to undefine.
  *
- * @see variable_get(), variable_set()
+ * @see variable_get()
+ * @see variable_set()
  */
 function variable_del($name) {
   global $conf;
@@ -2208,7 +2211,7 @@
  * - http://php.net/manual/en/language.variables.scope.php#language.variables.scope.static
  * - http://php.net/manual/en/language.variables.scope.php#language.variables.scope.references
  * The example below shows the syntax needed to work around both limitations.
- * For benchmarks and more information, @see http://drupal.org/node/619666.
+ * For benchmarks and more information, see http://drupal.org/node/619666.
  *
  * Example:
  * @code
Index: includes/common.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/common.inc,v
retrieving revision 1.1093
diff -u -r1.1093 common.inc
--- includes/common.inc	27 Jan 2010 11:41:20 -0000	1.1093
+++ includes/common.inc	28 Jan 2010 20:04:34 -0000
@@ -482,8 +482,8 @@
  *   A rawurlencoded string which can be used as or appended to the URL query
  *   string.
  *
- * @see drupal_get_query_parameters()
  * @ingroup php_wrappers
+ * @see drupal_get_query_parameters()
  */
 function drupal_http_build_query(array $query, $parent = '') {
   $params = array();
@@ -501,7 +501,7 @@
     }
     else {
       // For better readability of paths in query strings, we decode slashes.
-      // @see drupal_encode_path()
+      // See drupal_encode_path()
       $params[] = $key . '=' . str_replace('%2F', '/', rawurlencode($value));
     }
   }
@@ -570,9 +570,9 @@
  *   - 'query': An array of query parameters of $url, if existent.
  *   - 'fragment': The fragment of $url, if existent.
  *
+ * @ingroup php_wrappers
  * @see url()
  * @see drupal_goto()
- * @ingroup php_wrappers
  */
 function drupal_parse_url($url) {
   $options = array(
@@ -861,7 +861,7 @@
     // Mark that this request failed. This will trigger a check of the web
     // server's ability to make outgoing HTTP requests the next time that
     // requirements checking is performed.
-    // @see system_requirements()
+    // see system_requirements()
     variable_set('drupal_http_request_fails', TRUE);
 
     return $result;
@@ -1486,13 +1486,13 @@
  * Instead, translation of these data can be done through the locale system,
  * either directly or through helper functions provided by contributed
  * modules.
- * @see hook_locale()
+ * See hook_locale()
  *
  * During installation, st() is used in place of t(). Code that may be called
  * during installation or during normal operation should use the get_t()
  * helper function.
- * @see st()
- * @see get_t()
+ * See st()
+ * See get_t()
  *
  * @param $string
  *   A string containing the English string to translate.
@@ -2411,8 +2411,6 @@
  * else, the site-defined value for the 'anonymous' variable. However, a module
  * may override this by implementing hook_username_alter(&$name, $account).
  *
- * @see hook_username_alter()
- *
  * @param $account
  *   The account object for the user whose name is to be formatted.
  *
@@ -2420,6 +2418,8 @@
  *   An unsanitized string with the username to display. The code receiving
  *   this result must ensure that check_plain() is called on it before it is
  *   printed to the page.
+ *
+ * @see hook_username_alter()
  */
 function format_username($account) {
   $name = !empty($account->name) ? $account->name : variable_get('anonymous', t('Anonymous'));
@@ -4311,6 +4311,7 @@
  *   column should not be hidden.
  * @param $limit
  *   (optional) Limit the maximum amount of parenting in this table.
+ *   
  * @see block-admin-display-form.tpl.php
  * @see theme_menu_overview_form()
  */
@@ -4384,8 +4385,9 @@
  *
  * We use HTML-safe strings, i.e. with <, > and & escaped.
  *
- * @see drupal_json_decode()
  * @ingroup php_wrappers
+ *
+ * @see drupal_json_decode()
  */
 function drupal_json_encode($var) {
   // json_encode() does not escape <, > and &, so we do it with str_replace().
@@ -4395,8 +4397,9 @@
 /**
  * Converts an HTML-safe JSON string into its PHP equivalent.
  *
- * @see drupal_json_encode()
  * @ingroup php_wrappers
+ *
+ * @see drupal_json_encode()
  */
 function drupal_json_decode($var) {
   return json_decode($var, TRUE);
@@ -4580,7 +4583,7 @@
  * Page compression requires the PHP zlib extension
  * (http://php.net/manual/en/ref.zlib.php).
  *
- * @see drupal_page_header
+ * @see drupal_page_header()
  */
 function drupal_page_set_cache() {
   global $base_root;
@@ -4901,13 +4904,13 @@
  * Note that if also a #theme is defined for the element, then the result of
  * the theme callback will override #children.
  *
- * @see drupal_render()
- *
  * @param $elements
  *   A structured array using the #markup key.
  *
  * @return
  *   The passed in elements, but #markup appended to #children.
+ *   
+ * @see drupal_render()
  */
 function drupal_pre_render_markup($elements) {
   $elements['#children'] = $elements['#markup'];
@@ -4991,7 +4994,7 @@
  * property to an associative array with one or several of the following keys:
  *    - 'keys': An array of one or more keys that identify the element. If 'keys'
  *       is set, the cache ID is created automatically from these keys.
- *       @see drupal_render_cid_create()
+ *       See drupal_render_cid_create()
  *    - 'granularity' (optional): Define the cache granularity using binary
  *       combinations of the cache granularity constants, e.g. DRUPAL_CACHE_PER_USER
  *       to cache for each user separately or
@@ -5202,14 +5205,14 @@
 /**
  * Get the rendered output of a renderable element from cache.
  *
- * @see drupal_render()
- * @see drupal_render_cache_set()
- *
  * @param $elements
  *   A renderable array.
  * @return
  *   A markup string containing the rendered content of the element, or FALSE
  *   if no cached copy of the element is available.
+ *
+ * @see drupal_render()
+ * @see drupal_render_cache_set()
  */
 function drupal_render_cache_get($elements) {
   if (!in_array($_SERVER['REQUEST_METHOD'], array('GET', 'HEAD')) || !$cid = drupal_render_cid_create($elements)) {
@@ -5234,13 +5237,13 @@
  *
  * This is called by drupal_render() if the #cache property is set on an element.
  *
- * @see drupal_render()
- * @see drupal_render_cache_get()
- *
  * @param $markup
  *   The rendered output string of $elements.
  * @param $elements
  *   A renderable array.
+ *
+ * @see drupal_render()
+ * @see drupal_render_cache_get()
  */
 function drupal_render_cache_set(&$markup, $elements) {
   // Create the cache ID for the element.
@@ -6027,7 +6030,7 @@
  * - dependencies: An array of shortnames of other modules this module requires.
  * - package: The name of the package of modules this module belongs to.
  *
- * @see forum.info
+ * See forum.info
  *
  * Information stored in a theme .info file:
  * - name: The real name of the theme for display purposes
@@ -6040,7 +6043,7 @@
  * - stylesheets: Theme stylesheets eg: stylesheets[all][] = my-style.css
  * - scripts: Theme scripts eg: scripts[] = my-script.css
  *
- * @see garland.info
+ * See garland.info
  *
  * @param $filename
  *   The file we are parsing. Accepts file with relative or absolute path.
@@ -6372,12 +6375,12 @@
 /**
  * Get the entity info array of an entity type.
  *
- * @see hook_entity_info()
- * @see hook_entity_info_alter()
- *
  * @param $entity_type
  *   The entity type, e.g. node, for which the info shall be returned, or NULL
  *   to return an array with info about all types.
+ *   
+ * @see hook_entity_info()
+ * @see hook_entity_info_alter()
  */
 function entity_get_info($entity_type = NULL) {
   // Use the advanced drupal_static() pattern, since this is called very often.
@@ -6504,10 +6507,6 @@
  * extend the DrupalDefaultEntityController class. See node_entity_info() and
  * the NodeController in node.module as an example.
  *
- * @see hook_entity_info()
- * @see DrupalEntityController
- * @see DrupalDefaultEntityController
- *
  * @param $entity_type
  *   The entity type to load, e.g. node or user.
  * @param $ids
@@ -6519,6 +6518,10 @@
  *
  * @return
  *   An array of entity objects indexed by their ids.
+ *   
+ * @see hook_entity_info()
+ * @see DrupalEntityController
+ * @see DrupalDefaultEntityController
  */
 function entity_load($entity_type, $ids = array(), $conditions = array(), $reset = FALSE) {
   if ($reset) {
@@ -6553,12 +6556,13 @@
  * recursion. By convention, entity_prepare_view() is called after
  * field_attach_prepare_view() to allow entity level hooks to act on content
  * loaded by field API.
- * @see hook_entity_prepare_view()
  *
  * @param $entity_type
  *   The type of entity, i.e. 'node', 'user'.
  * @param $entities
  *   The entity objects which are being prepared for view, keyed by object ID.
+ *   
+ * @see hook_entity_prepare_view()
  */
 function entity_prepare_view($entity_type, $entities) {
   // To ensure hooks are only run once per entity, check for an
Index: includes/registry.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/registry.inc,v
retrieving revision 1.27
diff -u -r1.27 registry.inc
--- includes/registry.inc	28 Dec 2009 10:48:51 -0000	1.27
+++ includes/registry.inc	28 Jan 2010 20:04:38 -0000
@@ -17,7 +17,7 @@
  */
 
 /**
- * @see registry_update().
+ * @see registry_update()
  */
 function _registry_update() {
 
Index: includes/module.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/module.inc,v
retrieving revision 1.180
diff -u -r1.180 module.inc
--- includes/module.inc	28 Jan 2010 13:56:24 -0000	1.180
+++ includes/module.inc	28 Jan 2010 20:04:38 -0000
@@ -528,7 +528,7 @@
  * @return
  *   An array with the names of the modules which are implementing this hook.
  *
- * @see module_implements_write_cache().
+ * @see module_implements_write_cache()
  */
 function module_implements($hook, $sort = FALSE, $reset = FALSE) {
   // Use the advanced drupal_static() pattern, since this is called very often.
Index: includes/updater.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/updater.inc,v
retrieving revision 1.4
diff -u -r1.4 updater.inc
--- includes/updater.inc	25 Jan 2010 10:38:34 -0000	1.4
+++ includes/updater.inc	28 Jan 2010 20:04:40 -0000
@@ -202,7 +202,7 @@
    *   to the server.
    * @param array $overrides
    *   An array of settings to override defaults
-   *   @see self::getInstallArgs
+   *   See self::getInstallArgs()
    * @return array
    *   An array of links which the user may need to complete the update
    */
@@ -257,7 +257,7 @@
    *   Object which is a child of FileTransfer.
    * @param array $overrides
    *   An array of settings to override defaults.
-   *   @see self::getInstallArgs
+   *   See self::getInstallArgs()
    * @return array
    *   An array of links which the user may need to complete the install.
    */
Index: includes/form.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/form.inc,v
retrieving revision 1.427
diff -u -r1.427 form.inc
--- includes/form.inc	25 Jan 2010 10:38:34 -0000	1.427
+++ includes/form.inc	28 Jan 2010 20:04:37 -0000
@@ -192,7 +192,7 @@
       // Record the filepath of the include file containing the original form,
       // so the form builder callbacks can be loaded when the form is being
       // rebuilt from cache on a different path (such as 'system/ajax').
-      // @see form_get_cache()
+      // See form_get_cache()
       // menu_get_item() is not available at installation time.
       if (!isset($form_state['build_info']['file']) && !defined('MAINTENANCE_MODE')) {
         $item = menu_get_item();
@@ -358,7 +358,7 @@
         $form_state = $cached->data + $form_state;
 
         // If the original form is contained in an include file, load the file.
-        // @see drupal_build_form()
+        // See drupal_build_form()
         if (!empty($form_state['build_info']['file']) && file_exists($form_state['build_info']['file'])) {
           require_once DRUPAL_ROOT . '/' . $form_state['build_info']['file'];
         }
@@ -555,7 +555,7 @@
   // the actual form builder function ($callback) expects. This allows for
   // pre-populating a form with common elements for certain forms, such as
   // back/next/save buttons in multi-step form wizards.
-  // @see drupal_build_form()
+  // See drupal_build_form()
   if (isset($form_state['wrapper_callback']) && function_exists($form_state['wrapper_callback'])) {
     $form = call_user_func_array($form_state['wrapper_callback'], $args);
     // Put the prepopulated $form into $args.
@@ -1093,7 +1093,7 @@
  *   assume that certain data exists within $form_state['values'], and while not
  *   doing anything with that data that requires it to be valid, PHP errors
  *   would be triggered if the input processing and validation steps were fully
- *   skipped. @see http://drupal.org/node/370537.
+ *   skipped. See http://drupal.org/node/370537.
  *
  * @return
  *   Return value is for internal use only. To get a list of errors, use
@@ -2465,7 +2465,7 @@
  *     the tableselect element.
  *     Each option in $variables['element']['#options'] can contain an array
  *     keyed by '#attributes' which is added to the row's HTML attributes.
- *     @see theme_table
+ *     See theme_table()
  *     Properties used: header, options, empty, js_select.
  *
  * @return
Index: includes/tablesort.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/tablesort.inc,v
retrieving revision 1.58
diff -u -r1.58 tablesort.inc
--- includes/tablesort.inc	5 Dec 2009 20:17:02 -0000	1.58
+++ includes/tablesort.inc	28 Jan 2010 20:04:38 -0000
@@ -34,11 +34,13 @@
   /**
    * Order the query based on a header array.
    *
-   * @see theme_table()
    * @param $header
    *   Table header array.
+   *   
    * @return SelectQueryInterface
    *   The called object.
+   *   
+   * @see theme_table()
    */
   public function orderByHeader(Array $header) {
     $this->header = $header;
Index: includes/theme.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/theme.inc,v
retrieving revision 1.570
diff -u -r1.570 theme.inc
--- includes/theme.inc	25 Jan 2010 10:38:34 -0000	1.570
+++ includes/theme.inc	28 Jan 2010 20:04:40 -0000
@@ -15,7 +15,8 @@
  * @name Content markers
  * @{
  * Markers used by theme_mark() and node_mark() to designate content.
- * @see theme_mark(), node_mark()
+ * @see theme_mark()
+ * @see node_mark()
  */
 
 /**
@@ -429,7 +430,7 @@
           }
           foreach ($prefixes as $prefix) {
             // Only use non-hook-specific variable processors for theming hooks
-            // implemented as templates. @see theme().
+            // implemented as templates. See theme().
             if (isset($info['template']) && function_exists($prefix . '_' . $phase)) {
               $info[$phase_key][] = $prefix . '_' . $phase;
             }
@@ -466,7 +467,7 @@
             $cache[$hook][$phase_key] = array();
           }
           // Only use non-hook-specific variable processors for theming hooks
-          // implemented as templates. @see theme().
+          // implemented as templates. See theme().
           if (isset($info['template']) && function_exists($name . '_' . $phase)) {
             $cache[$hook][$phase_key][] = $name . '_' . $phase;
           }
@@ -1815,7 +1816,7 @@
  * @param $variables
  *   An associative array containing:
  *   - type: Number representing the marker type to display.
- *     @see MARK_NEW, MARK_UPDATED, MARK_READ
+ *     See MARK_NEW, MARK_UPDATED, MARK_READ
  *
  * @return
  *   A string containing the marker.
@@ -1985,7 +1986,7 @@
  * that the final string is safe to include directly in the output by using
  * check_plain() or filter_xss().
  *
- * @see theme_username().
+ * @see theme_username()
  */
 function template_preprocess_username(&$variables) {
   $account = $variables['account'];
@@ -2037,7 +2038,7 @@
 /**
  * Process variables for theme_username().
  *
- * @see theme_username().
+ * @see theme_username()
  */
 function template_process_username(&$variables) {
   // Finalize the link_options array for passing to the l() function.
@@ -2341,8 +2342,8 @@
  * Any changes to variables in this preprocessor should also be changed inside
  * template_preprocess_maintenance_page() to keep all of them consistent.
  *
- * @see drupal_render_page
- * @see template_process_page
+ * @see drupal_render_page()
+ * @see template_process_page()
  * @see page.tpl.php
  */
 function template_preprocess_page(&$variables) {
Index: modules/system/system.admin.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/system/system.admin.inc,v
retrieving revision 1.255
diff -u -r1.255 system.admin.inc
--- modules/system/system.admin.inc	26 Jan 2010 08:29:25 -0000	1.255
+++ modules/system/system.admin.inc	28 Jan 2010 20:04:55 -0000
@@ -810,7 +810,7 @@
  *
  * The list of modules gets populated by module.info files, which contain each module's name,
  * description and information about which modules it requires.
- * @see drupal_parse_info_file for information on module.info descriptors.
+ * See drupal_parse_info_file() for information on module.info descriptors.
  *
  * Dependency checking is performed to ensure that a module:
  * - can not be enabled if there are disabled modules it requires.
@@ -818,11 +818,12 @@
  *
  * @param $form_state
  *   An associative array containing the current state of the form.
+ * @return
+ *   The form array.
+ * 
  * @ingroup forms
  * @see theme_system_modules()
  * @see system_modules_submit()
- * @return
- *   The form array.
  */
 function system_modules($form, $form_state = array()) {
   // Get current list of modules.
@@ -1263,13 +1264,14 @@
 /**
  * Builds a form of currently disabled modules.
  *
- * @ingroup forms
- * @see system_modules_uninstall_validate()
- * @see system_modules_uninstall_submit()
  * @param $form_state['values']
  *   Submitted form values.
  * @return
  *   A form array representing the currently disabled modules.
+ *
+ * @ingroup forms
+ * @see system_modules_uninstall_validate()
+ * @see system_modules_uninstall_submit()
  */
 function system_modules_uninstall($form, $form_state = NULL) {
   // Make sure the install API is available.
@@ -2138,6 +2140,7 @@
  * Form builder; Configure the site's maintenance status.
  *
  * @ingroup forms
+ *
  * @see system_settings_form()
  */
 function system_site_maintenance_mode() {
@@ -2161,6 +2164,7 @@
  * Form builder; Configure clean URL settings.
  *
  * @ingroup forms
+ *
  * @see system_settings_form()
  */
 function system_clean_url_settings($form, &$form_state) {
@@ -2545,14 +2549,14 @@
 /**
  * Themes an incompatible message.
  *
- * @ingroup themeable
- *
  * @param $variables
  *   An associative array containing:
  *   - message: The form array representing the currently disabled modules.
  *
  * @return
  *   An HTML string for the message.
+ *
+ * @ingroup themeable
  */
 function theme_system_modules_incompatible($variables) {
   return '<div class="incompatible">' . $variables['message'] . '</div>';
@@ -2561,14 +2565,14 @@
 /**
  * Themes a table of currently disabled modules.
  *
- * @ingroup themeable
- *
  * @param $variables
  *   An associative array containing:
  *   - form: The form array representing the currently disabled modules.
  *
  * @return
  *   An HTML string representing the table.
+ *
+ * @ingroup themeable
  */
 function theme_system_modules_uninstall($variables) {
   $form = $variables['form'];
@@ -2904,6 +2908,7 @@
  *   Form definition.
  *
  * @ingroup forms
+ *
  * @see system_actions_manage_form_submit()
  */
 function system_actions_manage_form($form, &$form_state, $options = array()) {
@@ -3057,8 +3062,9 @@
 /**
  * Create the form for confirmation of deleting an action.
  *
- * @see system_actions_delete_form_submit()
  * @ingroup forms
+ *
+ * @see system_actions_delete_form_submit()
  */
 function system_actions_delete_form($form, &$form_state, $action) {
   $form['aid'] = array(
Index: modules/system/system.tar.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/system/system.tar.inc,v
retrieving revision 1.3
diff -u -r1.3 system.tar.inc
--- modules/system/system.tar.inc	9 Jan 2010 23:03:21 -0000	1.3
+++ modules/system/system.tar.inc	28 Jan 2010 20:04:59 -0000
@@ -225,8 +225,8 @@
 	*                           single string with names separated by a single
 	*                           blank space.
     * @return                   true on success, false on error.
-    * @see createModify()
     * @access public
+    * @see createModify()
     */
     function create($p_filelist)
     {
@@ -247,8 +247,8 @@
 	*                           single string with names separated by a single
 	*                           blank space.
     * @return                   true on success, false on error.
-    * @see createModify()
     * @access public
+    * @see createModify()
     */
     function add($p_filelist)
     {
@@ -483,6 +483,7 @@
 	*                               the file/dir path.
     * @return boolean               true on success, false on error.
     * @access public
+    *
     * @see extractList()
     */
     function extractModify($p_path, $p_remove_path)
@@ -504,6 +505,7 @@
     /**
     * This method extract from the archive one file identified by $p_filename.
     * The return value is a string with the file content, or NULL on error.
+    * 
     * @param string $p_filename     The path of the file to extract in a string.
     * @return                       a string with the file content or NULL.
     * @access public
@@ -538,6 +540,7 @@
 	*                               the file/dir path.
     * @return                       true on success, false on error.
     * @access public
+    *
     * @see extractModify()
     */
     function extractList($p_filelist, $p_path='', $p_remove_path='')
Index: modules/system/system.install
===================================================================
RCS file: /cvs/drupal/drupal/modules/system/system.install,v
retrieving revision 1.443
diff -u -r1.443 system.install
--- modules/system/system.install	25 Jan 2010 21:32:44 -0000	1.443
+++ modules/system/system.install	28 Jan 2010 20:04:57 -0000
@@ -2279,6 +2279,7 @@
 
 /**
  * Removed in favour of Drupal 6 backport.
+ *
  * @see system_update_6052()
  */
 function system_update_7031() {
@@ -2441,7 +2442,7 @@
   $insert->execute();
 
   // Remove obsolete variable 'site_offline_message'.
-  // @see update_fix_d7_requirements().
+  // See update_fix_d7_requirements().
   variable_del('site_offline_message');
 }
 
Index: modules/system/system.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/system/system.module,v
retrieving revision 1.880
diff -u -r1.880 system.module
--- modules/system/system.module	26 Jan 2010 08:29:25 -0000	1.880
+++ modules/system/system.module	28 Jan 2010 20:04:58 -0000
@@ -47,12 +47,16 @@
 define('DRUPAL_REQUIRED', 2);
 
 /**
- * Return only visible regions. @see system_region_list().
+ * Return only visible regions.
+ *
+ * @see system_region_list()
  */
 define('REGIONS_VISIBLE', 'visible');
 
 /**
- * Return all visible regions. @see system_region_list().
+ * Return all visible regions. 
+ *
+ * @see system_region_list()
  */
 define('REGIONS_ALL', 'all');
 
@@ -1586,7 +1590,7 @@
 /**
  * Setup and invoke an operation using authorize.php.
  *
- * @see system_authorized_init
+ * @see system_authorized_init()
  */
 function system_authorized_run($callback, $file, $arguments = array(), $page_title = NULL) {
   system_authorized_init($callback, $file, $arguments, $page_title);
@@ -2432,7 +2436,7 @@
       return $list[$theme_key][$show];
     }
     $info = $themes[$theme_key]->info;
-    // If requested, suppress hidden regions. @see block_admin_display_form().
+    // If requested, suppress hidden regions. See block_admin_display_form().
     foreach ($info['regions'] as $name => $label) {
       if ($show == REGIONS_ALL || !isset($info['regions_hidden']) || !in_array($name, $info['regions_hidden'])) {
         $list[$theme_key][$show][$name] = $label;
@@ -2488,8 +2492,6 @@
 /**
  * Add default buttons to a form and set its prefix.
  *
- * @ingroup forms
- * @see system_settings_form_submit()
  * @param $form
  *   An associative array containing the structure of the form.
  * @param $automatic_defaults
@@ -2497,6 +2499,10 @@
  *   (defaults to TRUE).
  * @return
  *   The form structure.
+ *
+ * @ingroup forms
+ *
+ * @see system_settings_form_submit()
  */
 function system_settings_form($form, $automatic_defaults = TRUE) {
   $form['actions']['#type'] = 'container';
@@ -2783,12 +2789,13 @@
 /**
  * Return a form definition so the Send email action can be configured.
  *
- * @see system_send_email_action_validate()
- * @see system_send_email_action_submit()
  * @param $context
  *   Default values (if we are editing an existing action instance).
  * @return
  *   Form definition.
+ *
+ * @see system_send_email_action_validate()
+ * @see system_send_email_action_submit()
  */
 function system_send_email_action_form($context) {
   // Set default values for form.
Index: modules/system/system.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/system/system.api.php,v
retrieving revision 1.121
diff -u -r1.121 system.api.php
--- modules/system/system.api.php	25 Jan 2010 10:38:35 -0000	1.121
+++ modules/system/system.api.php	28 Jan 2010 20:04:56 -0000
@@ -50,9 +50,6 @@
  * can be loaded via entity_load() and, optionally, to which fields can be
  * attached).
  *
- * @see entity_load()
- * @see hook_entity_info_alter()
- *
  * @return
  *   An array whose keys are entity type names and whose values identify
  *   properties of those types that the system needs to know about:
@@ -120,6 +117,9 @@
  *     the requested view mode. Keys of the array are view mode names. Each
  *     view mode is described by an array with the following key/value pairs:
  *     - label: The human-readable name of the view mode
+ *    
+ * @see entity_load()
+ * @see hook_entity_info_alter()
  */
 function hook_entity_info() {
   $return = array(
@@ -192,10 +192,10 @@
  * entity. All properties that are available in hook_entity_info() can be
  * altered here.
  *
- * @see hook_entity_info()
- *
  * @param $entity_info
  *   The entity info array, keyed by entity name.
+ *   
+ * @see hook_entity_info()
  */
 function hook_entity_info_alter(&$entity_info) {
   // Set the controller class for nodes to an alternate implementation of the
@@ -1149,6 +1149,7 @@
  *
  * @param $theme_registry
  *   The entire cache of theme registry information, post-processing.
+ *
  * @see hook_theme()
  * @see _theme_process_registry()
  */
@@ -1221,11 +1222,11 @@
  * definition, so module must be prepared to handle either format for
  * each callback being altered.
  *
- * @see hook_xmlrpc()
- *
  * @param $methods
  *   Associative array of method callback definitions returned from
  *   hook_xmlrpc.
+ *
+ * @see hook_xmlrpc()
  */
 function hook_xmlrpc_alter(&$methods) {
 
@@ -1397,10 +1398,10 @@
  * tables that will be cleared by the Clear button on the Performance page or
  * whenever drupal_flush_all_caches is invoked.
  *
- * @see drupal_flush_all_caches()
- *
  * @return
  *   An array of cache table names.
+ *
+ * @see drupal_flush_all_caches()
  */
 function hook_flush_caches() {
   return array('cache_example');
@@ -1414,10 +1415,10 @@
  * whereas hook_install() will only be called on the module actually
  * being installed.
  *
- * @see hook_install()
- *
  * @param $modules
  *   An array of the installed modules.
+ *
+ * @see hook_install()
  */
 function hook_modules_installed($modules) {
   if (in_array('lousy_module', $modules)) {
@@ -1433,10 +1434,10 @@
  * whereas hook_enable() will only be called on the module actually
  * being enabled.
  *
- * @see hook_enable()
- *
  * @param $modules
  *   An array of the enabled modules.
+ *
+ * @see hook_enable()
  */
 function hook_modules_enabled($modules) {
   if (in_array('lousy_module', $modules)) {
@@ -1453,10 +1454,10 @@
  * whereas hook_disable() will only be called on the module actually
  * being disabled.
  *
- * @see hook_disable()
- *
  * @param $modules
  *   An array of the disabled modules.
+ *
+ * @see hook_disable()
  */
 function hook_modules_disabled($modules) {
   if (in_array('lousy_module', $modules)) {
@@ -1475,10 +1476,10 @@
  * It is recommended that you implement this module if your module
  * stores data that may have been set by other modules.
  *
- * @see hook_uninstall()
- *
  * @param $modules
  *   The name of the uninstalled module.
+ *
+ * @see hook_uninstall()
  */
 function hook_modules_uninstalled($modules) {
   foreach ($modules as $module) {
@@ -1975,12 +1976,13 @@
  * Structured (aka dynamic) queries that have tags associated may be altered by any module
  * before the query is executed.
  *
+ * @param $query
+ *   A Query object describing the composite parts of a SQL query.
+ *
  * @see hook_query_TAG_alter()
  * @see node_query_node_access_alter()
  * @see QueryAlterableInterface
  * @see SelectQueryInterface
- * @param $query
- *   A Query object describing the composite parts of a SQL query.
  */
 function hook_query_alter(QueryAlterableInterface $query) {
   if ($query->hasTag('micro_limit')) {
@@ -1991,13 +1993,13 @@
 /**
  * Perform alterations to a structured query for a given tag.
  *
+ * @param $query
+ *   An Query object describing the composite parts of a SQL query.
+ *
  * @see hook_query_alter()
  * @see node_query_node_access_alter()
  * @see QueryAlterableInterface
  * @see SelectQueryInterface
- *
- * @param $query
- *   An Query object describing the composite parts of a SQL query.
  */
 function hook_query_TAG_alter(QueryAlterableInterface $query) {
   // Skip the extra expensive alterations if site has no node access control modules.
@@ -2669,11 +2671,11 @@
  * recommended that each date type starts with the module name. A date type
  * can consist of letters, numbers and underscores.
  *
- * @see hook_date_formats()
- * @see format_date()
- *
  * @return
  *   A list of date types in 'key' => 'label' format.
+ *
+ * @see hook_date_formats()
+ * @see format_date()
  */
 function hook_date_format_types() {
   return array(
@@ -2708,8 +2710,6 @@
  * that aren't specific to any one locale, for example, "Y m". For these cases
  * the locales field should be omitted.
  *
- * @see hook_date_format_types()
- *
  * @return
  *   A list of date formats. Each date format is a keyed array
  *   consisting of three elements:
@@ -2728,6 +2728,8 @@
  *     first one will be used unless overridden via
  *     admin/config/regional/date-time/locale. If your date format is not
  *     language specific, leave this field empty.
+ *
+ * @see hook_date_format_types()
  */
 function hook_date_formats() {
   return array(
Index: modules/aggregator/aggregator.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/aggregator/aggregator.api.php,v
retrieving revision 1.7
diff -u -r1.7 aggregator.api.php
--- modules/aggregator/aggregator.api.php	8 Jan 2010 11:03:54 -0000	1.7
+++ modules/aggregator/aggregator.api.php	28 Jan 2010 20:04:41 -0000
@@ -31,11 +31,11 @@
  * @return
  *   TRUE if fetching was successful, FALSE otherwise.
  *
+ * @ingroup aggregator
+ *
  * @see hook_aggregator_fetch_info()
  * @see hook_aggregator_parse()
  * @see hook_aggregator_process()
- *
- * @ingroup aggregator
  */
 function hook_aggregator_fetch($feed) {
   $feed->source_string = mymodule_fetch($feed->url);
@@ -57,9 +57,9 @@
  * @return
  *   An associative array defining a title and a description string.
  *
- * @see hook_aggregator_fetch()
- *
  * @ingroup aggregator
+ *
+ * @see hook_aggregator_fetch()
  */
 function hook_aggregator_fetch_info() {
   return array(
@@ -108,11 +108,11 @@
  * @return
  *   TRUE if parsing was successful, FALSE otherwise.
  *
+ * @ingroup aggregator
+ *
  * @see hook_aggregator_parse_info()
  * @see hook_aggregator_fetch()
  * @see hook_aggregator_process()
- *
- * @ingroup aggregator
  */
 function hook_aggregator_parse($feed) {
   if ($items = mymodule_parse($feed->source_string)) {
@@ -138,9 +138,9 @@
  * @return
  *   An associative array defining a title and a description string.
  *
- * @see hook_aggregator_parse()
- *
  * @ingroup aggregator
+ *
+ * @see hook_aggregator_parse()
  */
 function hook_aggregator_parse_info() {
   return array(
@@ -168,11 +168,11 @@
  *   in the $feed->items array. For the exact format refer to the particular
  *   parser in use.
  *
+ * @ingroup aggregator
+ *
  * @see hook_aggregator_process_info()
  * @see hook_aggregator_fetch()
  * @see hook_aggregator_parse()
- *
- * @ingroup aggregator
  */
 function hook_aggregator_process($feed) {
   foreach ($feed->items as $item) {
@@ -196,9 +196,9 @@
  * @return
  *   An associative array defining a title and a description string.
  *
- * @see hook_aggregator_process()
- *
  * @ingroup aggregator
+ *
+ * @see hook_aggregator_process()
  */
 function hook_aggregator_process_info($feed) {
   return array(
Index: modules/forum/forum-topic-list.tpl.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/forum/forum-topic-list.tpl.php,v
retrieving revision 1.8
diff -u -r1.8 forum-topic-list.tpl.php
--- modules/forum/forum-topic-list.tpl.php	8 Oct 2009 07:58:45 -0000	1.8
+++ modules/forum/forum-topic-list.tpl.php	28 Jan 2010 20:04:46 -0000
@@ -7,7 +7,7 @@
  *
  * Available variables:
  * - $header: The table header. This is pre-generated with click-sorting
- *   information. If you need to change this, @see template_preprocess_forum_topic_list().
+ *   information. If you need to change this, see template_preprocess_forum_topic_list().
  * - $pager: The pager to display beneath the table.
  * - $topics: An array of topics to be displayed.
  * - $topic_id: Numeric id for the current forum topic.
Index: modules/forum/forum.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/forum/forum.module,v
retrieving revision 1.553
diff -u -r1.553 forum.module
--- modules/forum/forum.module	14 Jan 2010 06:20:15 -0000	1.553
+++ modules/forum/forum.module	28 Jan 2010 20:04:47 -0000
@@ -647,10 +647,10 @@
 /**
 * A #pre_render callback. Lists nodes based on the element's #query property.
 *
-* @see forum_block_view().
-*
 * @return
 *   A renderable array.
+*
+* @see forum_block_view()
 */
 function forum_block_view_pre_render($elements) {
   $result = $elements['#query']->execute();
Index: modules/filter/filter.pages.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/filter/filter.pages.inc,v
retrieving revision 1.9
diff -u -r1.9 filter.pages.inc
--- modules/filter/filter.pages.inc	13 Oct 2009 15:39:41 -0000	1.9
+++ modules/filter/filter.pages.inc	28 Jan 2010 20:04:46 -0000
@@ -45,8 +45,9 @@
  *     (TRUE), or are in a short format, i.e. suitable to be displayed below a
  *     form element. Defaults to FALSE.
  *
- * @see _filter_tips()
  * @ingroup themeable
+ *
+ * @see _filter_tips()
  */
 function theme_filter_tips($variables) {
   $tips = $variables['tips'];
Index: modules/filter/filter.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/filter/filter.api.php,v
retrieving revision 1.17
diff -u -r1.17 filter.api.php
--- modules/filter/filter.api.php	13 Dec 2009 20:03:11 -0000	1.17
+++ modules/filter/filter.api.php	28 Jan 2010 20:04:46 -0000
@@ -208,8 +208,8 @@
  * @param $format
  *   The format object of the format being updated.
  *
- * @see hook_filter_format_update().
- * @see hook_filter_format_delete().
+ * @see hook_filter_format_update()
+ * @see hook_filter_format_delete()
  */
 function hook_filter_format_insert($format) {
   mymodule_cache_rebuild();
@@ -225,8 +225,8 @@
  * @param $format
  *   The format object of the format being updated.
  *
- * @see hook_filter_format_insert().
- * @see hook_filter_format_delete().
+ * @see hook_filter_format_insert()
+ * @see hook_filter_format_delete()
  */
 function hook_filter_format_update($format) {
   mymodule_cache_rebuild();
@@ -245,8 +245,8 @@
  *   The format object of the site's fallback format, which is always available
  *   to all users.
  *
- * @see hook_filter_format_update().
- * @see hook_filter_format_delete().
+ * @see hook_filter_format_update()
+ * @see hook_filter_format_delete()
  */
 function hook_filter_format_delete($format, $fallback) {
   // Replace the deleted format with the fallback format.
Index: modules/simpletest/tests/path.test
===================================================================
RCS file: /cvs/drupal/drupal/modules/simpletest/tests/path.test,v
retrieving revision 1.3
diff -u -r1.3 path.test
--- modules/simpletest/tests/path.test	21 Jan 2010 04:20:08 -0000	1.3
+++ modules/simpletest/tests/path.test	28 Jan 2010 20:04:53 -0000
@@ -9,7 +9,7 @@
 /**
  * Unit tests for the drupal_match_path() function in path.inc.
  *
- * @see drupal_match_path().
+ * @see drupal_match_path()
  */
 class DrupalMatchPathTestCase extends DrupalWebTestCase {
   protected $front;
Index: modules/simpletest/tests/image_test.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/simpletest/tests/image_test.module,v
retrieving revision 1.5
diff -u -r1.5 image_test.module
--- modules/simpletest/tests/image_test.module	4 Dec 2009 16:49:47 -0000	1.5
+++ modules/simpletest/tests/image_test.module	28 Jan 2010 20:04:53 -0000
@@ -25,7 +25,7 @@
 /**
  * Reset/initialize the history of calls to the toolkit functions.
  *
- * @see image_test_get_all_calls().
+ * @see image_test_get_all_calls()
  */
 function image_test_reset() {
   // Keep track of calls to these operations
Index: modules/simpletest/tests/actions.test
===================================================================
RCS file: /cvs/drupal/drupal/modules/simpletest/tests/actions.test,v
retrieving revision 1.12
diff -u -r1.12 actions.test
--- modules/simpletest/tests/actions.test	10 Jan 2010 17:19:01 -0000	1.12
+++ modules/simpletest/tests/actions.test	28 Jan 2010 20:04:51 -0000
@@ -97,7 +97,7 @@
     // To prevent this test from failing when xdebug is enabled, the maximum
     // recursion level should be kept low enough to prevent the xdebug
     // infinite recursion protection mechanism from aborting the request.
-    // @see http://drupal.org/node/587634.
+    // See http://drupal.org/node/587634.
     variable_set('actions_max_stack', mt_rand(3, 12));
     $this->triggerActions();
   }
Index: modules/simpletest/tests/database_test.test
===================================================================
RCS file: /cvs/drupal/drupal/modules/simpletest/tests/database_test.test,v
retrieving revision 1.80
diff -u -r1.80 database_test.test
--- modules/simpletest/tests/database_test.test	13 Jan 2010 05:49:41 -0000	1.80
+++ modules/simpletest/tests/database_test.test	28 Jan 2010 20:04:53 -0000
@@ -2199,7 +2199,7 @@
 /**
  * Select alter tests.
  *
- * @see database_test_query_alter().
+ * @see database_test_query_alter()
  */
 class DatabaseAlterTestCase extends DatabaseTestCase {
 
@@ -2283,7 +2283,7 @@
 /**
  * Select alter tests, part 2.
  *
- * @see database_test_query_alter().
+ * @see database_test_query_alter()
  */
 class DatabaseAlter2TestCase extends DatabaseTestCase {
 
Index: modules/simpletest/tests/form.test
===================================================================
RCS file: /cvs/drupal/drupal/modules/simpletest/tests/form.test,v
retrieving revision 1.33
diff -u -r1.33 form.test
--- modules/simpletest/tests/form.test	8 Jan 2010 06:36:34 -0000	1.33
+++ modules/simpletest/tests/form.test	28 Jan 2010 20:04:53 -0000
@@ -123,7 +123,7 @@
   /**
    * Test default value handling for checkboxes.
    *
-   * @see _form_test_checkbox().
+   * @see _form_test_checkbox()
    */
   function testCheckboxProcessing() {
     // First, try to submit without the required checkbox.
@@ -153,7 +153,7 @@
   /**
    * Test handling of disabled elements.
    *
-   * @see _form_test_disabled_elements().
+   * @see _form_test_disabled_elements()
    */
   function testDisabledElements() {
     // Submit the form, and fetch the default values.
Index: modules/simpletest/tests/file_test.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/simpletest/tests/file_test.module,v
retrieving revision 1.19
diff -u -r1.19 file_test.module
--- modules/simpletest/tests/file_test.module	4 Dec 2009 16:49:47 -0000	1.19
+++ modules/simpletest/tests/file_test.module	28 Jan 2010 20:04:53 -0000
@@ -176,7 +176,7 @@
  *   One of the hook_file_[validate,download,references] operations.
  * @return
  *   Value set by file_test_set_return().
-* @see file_test_set_return() and file_test_reset().
+* @see file_test_set_return() and file_test_reset()
  */
 function _file_test_get_return($op) {
   $return = variable_get('file_test_return', array($op => NULL));
@@ -190,7 +190,7 @@
  *   One of the hook_file_[validate,download,references] operations.
  * @param $value
  *   Value for the hook to return.
- * @see _file_test_get_return() and file_test_reset().
+ * @see _file_test_get_return() and file_test_reset()
  */
 function file_test_set_return($op, $value) {
   $return = variable_get('file_test_return', array());
Index: modules/simpletest/tests/form_test.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/simpletest/tests/form_test.module,v
retrieving revision 1.26
diff -u -r1.26 form_test.module
--- modules/simpletest/tests/form_test.module	8 Jan 2010 06:36:34 -0000	1.26
+++ modules/simpletest/tests/form_test.module	28 Jan 2010 20:04:53 -0000
@@ -376,7 +376,7 @@
  * request parameter "cache" the form can be tested with caching enabled, as
  * it would be the case, if the form would contain some #ajax callbacks.
  *
- * @see form_test_storage_form_submit().
+ * @see form_test_storage_form_submit()
  */
 function form_test_storage_form($form, &$form_state) {
   if ($form_state['rebuild']) {
@@ -454,7 +454,7 @@
   if (isset($_REQUEST['cache']) && $form_state['values']['value'] == 'change_title') {
     $form_state['storage']['thing']['changed'] = TRUE;
     // @todo Fix FAPI to make it unnecessary to explicitly set the cache flag in
-    //   this situation. @see http://drupal.org/node/641356.
+    //   this situation. See http://drupal.org/node/641356.
     $form_state['cache'] = TRUE;
   }
 }
Index: profiles/standard/standard.install
===================================================================
RCS file: /cvs/drupal/drupal/profiles/standard/standard.install,v
retrieving revision 1.5
diff -u -r1.5 standard.install
--- profiles/standard/standard.install	15 Jan 2010 10:09:03 -0000	1.5
+++ profiles/standard/standard.install	28 Jan 2010 20:05:01 -0000
@@ -320,7 +320,7 @@
 
   // Create an image field named "Image", enabled for the 'article' content type.
   // Many of the following values will be defaulted, they're included here as an illustrative examples.
-  // @see: http://api.drupal.org/api/function/field_create_field/7
+  // See http://api.drupal.org/api/function/field_create_field/7
 
   $field = array(
     'field_name' => 'field_image',
@@ -342,7 +342,7 @@
 
 
   // Many of the following values will be defaulted, they're included here as an illustrative examples.
-  // @see: http://api.drupal.org/api/function/field_create_instance/7
+  // See http://api.drupal.org/api/function/field_create_instance/7
   $instance = array(
     'field_name' => 'field_image',
     'object_type' => 'node',
Index: modules/user/user.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/user/user.module,v
retrieving revision 1.1113
diff -u -r1.1113 user.module
--- modules/user/user.module	27 Jan 2010 11:24:32 -0000	1.1113
+++ modules/user/user.module	28 Jan 2010 20:05:01 -0000
@@ -1805,11 +1805,12 @@
  * We use three validators instead of one since external authentication
  * modules usually only need to alter the second validator.
  *
+ * @return array
+ *   A simple list of validate functions.
+ *
  * @see user_login_name_validate()
  * @see user_login_authenticate_validate()
  * @see user_login_final_validate()
- * @return array
- *   A simple list of validate functions.
  */
 function user_login_default_validators() {
   return array('user_login_name_validate', 'user_login_authenticate_validate', 'user_login_final_validate');
@@ -3012,9 +3013,6 @@
  * Conditionally create and send a notification email when a certain
  * operation happens on the given user account.
  *
- * @see user_mail_tokens()
- * @see drupal_mail()
- *
  * @param $op
  *  The operation being performed on the account. Possible values:
  *  'register_admin_created': Welcome message for user created by the admin
@@ -3033,6 +3031,9 @@
  *  Optional language to use for the notification, overriding account language.
  * @return
  *  The return value from drupal_mail_system()->mail(), if ends up being called.
+ *
+ * @see user_mail_tokens()
+ * @see drupal_mail()
  */
 function _user_mail_notify($op, $account, $language = NULL) {
   // By default, we always notify except for canceled and blocked.
Index: modules/user/user-profile-category.tpl.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/user/user-profile-category.tpl.php,v
retrieving revision 1.3
diff -u -r1.3 user-profile-category.tpl.php
--- modules/user/user-profile-category.tpl.php	13 Oct 2008 12:31:43 -0000	1.3
+++ modules/user/user-profile-category.tpl.php	28 Jan 2010 20:05:00 -0000
@@ -10,10 +10,10 @@
  * It can also be defined by modules. All profile items for a category will be
  * output through the $profile_items variable.
  *
- * @see user-profile-item.tpl.php
+ * See user-profile-item.tpl.php
  *      where each profile item is rendered. It is implemented as a definition
  *      list by default.
- * @see user-profile.tpl.php
+ * See user-profile.tpl.php
  *      where all items and categories are collected and printed out.
  *
  * Available variables:
Index: modules/user/user-profile.tpl.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/user/user-profile.tpl.php,v
retrieving revision 1.13
diff -u -r1.13 user-profile.tpl.php
--- modules/user/user-profile.tpl.php	8 Jan 2010 07:04:09 -0000	1.13
+++ modules/user/user-profile.tpl.php	28 Jan 2010 20:05:00 -0000
@@ -26,10 +26,11 @@
  *     field language, e.g. $user->field_example['en'], thus overriding any
  *     language negotiation rule that was previously applied.
  *
- * @see user-profile-category.tpl.php
+ * See user-profile-category.tpl.php
  *   Where the html is handled for the group.
- * @see user-profile-item.tpl.php
+ * See user-profile-item.tpl.php
  *   Where the html is handled for each item in the group.
+ *   
  * @see template_preprocess_user_profile()
  */
 ?>
Index: modules/user/user-profile-item.tpl.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/user/user-profile-item.tpl.php,v
retrieving revision 1.3
diff -u -r1.3 user-profile-item.tpl.php
--- modules/user/user-profile-item.tpl.php	13 Oct 2008 12:31:43 -0000	1.3
+++ modules/user/user-profile-item.tpl.php	28 Jan 2010 20:05:00 -0000
@@ -10,9 +10,9 @@
  * for the user's account. It can also be the data from modules. The output is
  * grouped by categories.
  *
- * @see user-profile-category.tpl.php
+ * See user-profile-category.tpl.php
  *      for the parent markup. Implemented as a definition list by default.
- * @see user-profile.tpl.php
+ * See user-profile.tpl.php
  *      where all items and categories are collected and printed out.
  *
  * Available variables:
Index: modules/image/image.effects.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/image/image.effects.inc,v
retrieving revision 1.3
diff -u -r1.3 image.effects.inc
--- modules/image/image.effects.inc	4 Dec 2009 16:49:46 -0000	1.3
+++ modules/image/image.effects.inc	28 Jan 2010 20:04:47 -0000
@@ -201,9 +201,11 @@
  *   - "bgcolor": The background color to use for exposed areas of the image.
  *     Use web-style hex colors (#FFFFFF for white, #000000 for black). Leave
  *     blank for transparency on image types that support it.
+ *
  * @return
  *   TRUE on success. FALSE on failure to rotate image.
- * @see image_rotate().
+ *
+ * @see image_rotate()
  */
 function image_rotate_effect(&$image, $data) {
   // Set sane default values.
Index: modules/image/image.admin.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/image/image.admin.inc,v
retrieving revision 1.17
diff -u -r1.17 image.admin.inc
--- modules/image/image.admin.inc	3 Jan 2010 21:01:04 -0000	1.17
+++ modules/image/image.admin.inc	28 Jan 2010 20:04:47 -0000
@@ -629,8 +629,8 @@
  *   An associative array containing:
  *   - styles: An array of all the image styles returned by image_get_styles().
  *
- * @see image_get_styles()
  * @ingroup themeable
+ * @see image_get_styles()
  */
 function theme_image_style_list($variables) {
   $styles = $variables['styles'];
Index: modules/overlay/overlay.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/overlay/overlay.module,v
retrieving revision 1.8
diff -u -r1.8 overlay.module
--- modules/overlay/overlay.module	18 Jan 2010 17:12:04 -0000	1.8
+++ modules/overlay/overlay.module	28 Jan 2010 20:04:49 -0000
@@ -315,13 +315,13 @@
  * processing, so that it's possible to close the overlay after submitting
  * a form.
  *
+ * @ingroup forms
+ *
  * @see _form_builder_handle_input_element()
  * @see _form_builder_ie_cleanup()
  * @see form_execute_handlers()
  * @see form_builder()
  * @see overlay_form_submit()
- *
- * @ingroup forms
  */
 function overlay_form_after_build($form, &$form_state) {
   if (overlay_get_mode() == 'child') {
@@ -355,8 +355,8 @@
  * we need to output the JavaScript that will tell the parent window to close
  * the child dialog.
  *
- * @see overlay_get_mode()
  * @ingroup forms
+ * @see overlay_get_mode()
  */
 function overlay_form_submit($form, &$form_state) {
   $settings = &drupal_static(__FUNCTION__);
Index: modules/overlay/overlay-parent.js
===================================================================
RCS file: /cvs/drupal/drupal/modules/overlay/overlay-parent.js,v
retrieving revision 1.22
diff -u -r1.22 overlay-parent.js
--- modules/overlay/overlay-parent.js	14 Jan 2010 04:06:54 -0000	1.22
+++ modules/overlay/overlay-parent.js	28 Jan 2010 20:04:49 -0000
@@ -294,7 +294,7 @@
   // While the overlay is loading, we remove the loaded class from the dialog.
   // After the loading is finished, the loaded class is added back. The loaded 
   // class is being used to hide the iframe while loading.
-  // @see overlay-parent.css .overlay-loaded #overlay-element
+  // See overlay-parent.css .overlay-loaded #overlay-element
   self.$dialog.removeClass('overlay-loaded');
   self.$iframe
     .bind('load.overlay-event', function () {
@@ -310,7 +310,7 @@
   });
 
   // Get the document object of the iframe window.
-  // @see http://xkr.us/articles/dom/iframe-document/
+  // See http://xkr.us/articles/dom/iframe-document/
   var iframeDocument = (iframeElement.contentWindow || iframeElement.contentDocument);
   if (iframeDocument.document) {
     iframeDocument = iframeDocument.document;
@@ -398,8 +398,8 @@
   // handler interferes with use of the scroll bar in Chrome & Safari.
   // After unbinding from the document we bind a handler to the dialog overlay
   // which returns false to prevent event bubbling.
-  // @see http://dev.jqueryui.com/ticket/4671
-  // @see https://bugs.webkit.org/show_bug.cgi?id=19033
+  // See http://dev.jqueryui.com/ticket/4671
+  // See https://bugs.webkit.org/show_bug.cgi?id=19033
   // Do the same for the click handler as prevents default handling of clicks in
   // displaced regions (e.g. opening a link in a new browser tab when CTRL was
   // pressed while clicking).
Index: modules/node/node.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/node/node.module,v
retrieving revision 1.1221
diff -u -r1.1221 node.module
--- modules/node/node.module	28 Jan 2010 07:10:59 -0000	1.1221
+++ modules/node/node.module	28 Jan 2010 20:04:49 -0000
@@ -426,12 +426,12 @@
  * The base indicates which module implement this node type and is used to
  * execute node type specific hooks.
  *
- * @see node_invoke()
- *
  * @param $node
  *   A node object or string that indicates the node type to return.
  * @return
  *   The node type base or FALSE if the node type is not found.
+ *
+ * @see node_invoke()
  */
 function node_type_get_base($node) {
   $type = _node_extract_type($node);
Index: modules/node/node.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/node/node.api.php,v
retrieving revision 1.59
diff -u -r1.59 node.api.php
--- modules/node/node.api.php	25 Jan 2010 10:38:34 -0000	1.59
+++ modules/node/node.api.php	28 Jan 2010 20:04:47 -0000
@@ -116,15 +116,15 @@
  * modules to modify the $grants array by reference before it is stored, so
  * custom or advanced business logic can be applied.
  *
- * @see hook_node_access_records()
+ * See hook_node_access_records()
  *
  * Upon viewing, editing or deleting a node, hook_node_grants() builds a
  * permissions array that is compared against the stored access records. The
  * user must have one or more matching permissions in order to complete the
  * requested operation.
  *
- * @see hook_node_grants()
- * @see hook_node_grants_alter()
+ * See hook_node_grants()
+ * See hook_node_grants_alter()
  *
  * @param &$grants
  *   The $grants array returned by hook_node_access_records().
@@ -161,13 +161,13 @@
  * multiple node access modules can be altered or advanced business logic can be
  * applied.
  *
- * @see hook_node_grants()
+ * See hook_node_grants()
  *
  * The resulting grants are then checked against the records stored in the
  * {node_access} table to determine if the operation may be completed.
  *
- * @see hook_node_access_records()
- * @see hook_node_access_records_alter()
+ * See hook_node_access_records()
+ * See hook_node_access_records_alter()
  *
  * @param &$grants
  *   The $grants array returned by hook_node_grants().
@@ -552,16 +552,16 @@
  * When $view_mode is 'rss', modules can also add extra RSS elements and
  * namespaces to $node->rss_elements and $node->rss_namespaces respectively for
  * the RSS item generated for this node.
- * For details on how this is used @see node_feed()
- *
- * @see taxonomy_node_view()
- * @see upload_node_view()
- * @see comment_node_view()
+ * For details on how this is used see node_feed()
  *
  * @param $node
  *   The node that is being assembled for rendering.
  * @param $view_mode
  *   The $view_mode parameter from node_view().
+ *   
+ * @see taxonomy_node_view()
+ * @see upload_node_view()
+ * @see comment_node_view()
  */
 function hook_node_view($node, $view_mode) {
   $node->content['my_additional_field'] = array(
Index: modules/simpletest/simpletest.install
===================================================================
RCS file: /cvs/drupal/drupal/modules/simpletest/simpletest.install,v
retrieving revision 1.34
diff -u -r1.34 simpletest.install
--- modules/simpletest/simpletest.install	15 Jan 2010 22:46:59 -0000	1.34
+++ modules/simpletest/simpletest.install	28 Jan 2010 20:04:51 -0000
@@ -68,7 +68,7 @@
 
   // SimpleTest currently needs 2 cURL options which are incompatible with
   // having PHP's open_basedir restriction set.
-  // @see http://drupal.org/node/674304.
+  // See http://drupal.org/node/674304.
   $requirements['php_open_basedir'] = array(
     'title' => $t('PHP open_basedir restriction'),
     'value' => $open_basedir ? $t('Enabled') : $t('Disabled'),
Index: modules/simpletest/drupal_web_test_case.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/simpletest/drupal_web_test_case.php,v
retrieving revision 1.193
diff -u -r1.193 drupal_web_test_case.php
--- modules/simpletest/drupal_web_test_case.php	15 Jan 2010 03:07:34 -0000	1.193
+++ modules/simpletest/drupal_web_test_case.php	28 Jan 2010 20:04:51 -0000
@@ -1363,12 +1363,12 @@
   /**
    * Reads headers and registers errors received from the tested site.
    *
-   * @see _drupal_log_error().
-   *
    * @param $curlHandler
    *   The cURL handler.
    * @param $header
    *   An header.
+   *
+   * @see _drupal_log_error().
    */
   protected function curlHeaderCallback($curlHandler, $header) {
     $this->headers[] = $header;
Index: modules/field/field.info.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/field/field.info.inc,v
retrieving revision 1.37
diff -u -r1.37 field.info.inc
--- modules/field/field.info.inc	13 Jan 2010 04:37:03 -0000	1.37
+++ modules/field/field.info.inc	28 Jan 2010 20:04:45 -0000
@@ -528,7 +528,7 @@
  *   additional element 'bundles', whose value is an array of all the bundles
  *   this field belongs to.
  *
- * @see field_info_field_by_id().
+ * @see field_info_field_by_id()
  */
 function field_info_field($field_name) {
   $info = _field_info_collate_fields();
@@ -549,7 +549,7 @@
  *   additional element 'bundles', whose value is an array of all the bundles
  *   this field belongs to.
  *
- * @see field_info_field().
+ * @see field_info_field()
  */
 function field_info_field_by_id($field_id) {
   $info = _field_info_collate_fields();
Index: modules/field/field.attach.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/field/field.attach.inc,v
retrieving revision 1.72
diff -u -r1.72 field.attach.inc
--- modules/field/field.attach.inc	12 Jan 2010 06:21:34 -0000	1.72
+++ modules/field/field.attach.inc	28 Jan 2010 20:04:44 -0000
@@ -376,7 +376,7 @@
  * Use _field_invoke() to invoke the field type implementation,
  * hook_field_[op]().
  *
- * @see _field_invoke().
+ * @see _field_invoke()
  */
 function _field_invoke_default($op, $obj_type, $object, &$a = NULL, &$b = NULL, $options = array()) {
   $options['default'] = TRUE;
@@ -390,7 +390,7 @@
  * Use _field_invoke_multiple() to invoke the field type implementation,
  * hook_field_[op]().
  *
- * @see _field_invoke_multiple().
+ * @see _field_invoke_multiple()
  */
 function _field_invoke_multiple_default($op, $obj_type, $objects, &$a = NULL, &$b = NULL, $options = array()) {
   $options['default'] = TRUE;
Index: modules/field/field.default.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/field/field.default.inc,v
retrieving revision 1.30
diff -u -r1.30 field.default.inc
--- modules/field/field.default.inc	26 Dec 2009 16:50:08 -0000	1.30
+++ modules/field/field.default.inc	28 Jan 2010 20:04:44 -0000
@@ -27,8 +27,6 @@
  * Possible error codes:
  * - 'field_cardinality': The number of values exceeds the field cardinality.
  *
- * @see _hook_field_validate()
- *
  * @param $obj_type
  *   The type of $object.
  * @param $object
@@ -48,6 +46,8 @@
  *   keys and values:
  *   - 'error': an error code (should be a string, prefixed with the module name)
  *   - 'message': the human readable message to be displayed.
+ *
+ * @see _hook_field_validate()
  */
 function field_default_validate($obj_type, $object, $field, $instance, $langcode, $items, &$errors) {
   // Filter out empty values.
Index: modules/field/field.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/field/field.api.php,v
retrieving revision 1.62
diff -u -r1.62 field.api.php
--- modules/field/field.api.php	25 Jan 2010 10:38:34 -0000	1.62
+++ modules/field/field.api.php	28 Jan 2010 20:04:44 -0000
@@ -75,26 +75,26 @@
  * can be attached to a fieldable object. hook_field_info() defines the basic
  * properties of a field type, and a variety of other field hooks are called by
  * the Field Attach API to perform field-type-specific actions.
- * @see hook_field_info().
- * @see hook_field_info_alter().
- * @see hook_field_schema().
- * @see hook_field_load().
- * @see hook_field_validate().
- * @see hook_field_presave().
- * @see hook_field_insert().
- * @see hook_field_update().
- * @see hook_field_delete().
- * @see hook_field_delete_revision().
- * @see hook_field_prepare_view().
- * @see hook_field_is_empty().
+ * See hook_field_info()
+ * See hook_field_info_alter()
+ * See hook_field_schema()
+ * See hook_field_load()
+ * See hook_field_validate()
+ * See hook_field_presave()
+ * See hook_field_insert()
+ * See hook_field_update()
+ * See hook_field_delete()
+ * See hook_field_delete_revision()
+ * See hook_field_prepare_view()
+ * See hook_field_is_empty()
  *
  * The Field Types API also defines two kinds of pluggable handlers: widgets
  * and formatters, which specify how the field appears in edit forms and in
  * displayed objects. Widgets and formatters can be implemented by a field-type
  * module for it's own field types, or by a third-party module to extend the
  * behavior of existing field types.
- * @see hook_field_widget_info().
- * @see hook_field_formatter_info().
+ * See hook_field_widget_info()
+ * See hook_field_formatter_info()
  *
  * A third kind of pluggable handlers, storage backends, is defined by the
  * @link field_storage Field Storage API @endlink.
@@ -295,7 +295,6 @@
  * This hook is invoked before the field values are handed to formatters
  * for display, and runs before the formatters' own
  * hook_field_formatter_prepare_view().
- * @see hook_field_formatter_prepare_view()
  *
  * Unlike most other field hooks, this hook operates on multiple objects. The
  * $objects, $instances and $items parameters are arrays keyed by object id.
@@ -315,6 +314,8 @@
  *   The language associated to $items.
  * @param $items
  *   $object->{$field['field_name']}, or an empty array if unset.
+ *
+ * @see hook_field_formatter_prepare_view()
  */
 function hook_field_prepare_view($obj_type, $objects, $field, $instances, $langcode, &$items) {
   // Sample code from image.module: if there are no images specified at all,
@@ -522,9 +523,6 @@
  * Widgets are Form API elements with additional processing capabilities.
  * Widget hooks are typically called by the Field Attach API during the
  * creation of the field form structure with field_attach_form().
- * @see hook_field_widget_info_alter().
- * @see hook_field_widget_form().
- * @see hook_field_widget_error().
  *
  * @return
  *   An array describing the widget types implemented by the module.
@@ -551,6 +549,10 @@
  *     - default value:
  *       FIELD_BEHAVIOR_DEFAULT (default) if the widget accepts default values.
  *       FIELD_BEHAVIOR_NONE if the widget does not support default values.
+ *       
+ * @see hook_field_widget_info_alter()
+ * @see hook_field_widget_form()
+ * @see hook_field_widget_error()
  */
 function hook_field_widget_info() {
     return array(
@@ -680,11 +682,6 @@
  * called by the Field Attach API field_attach_prepare_view() and
  * field_attach_view() functions.
  *
- * @see hook_field_formatter_info().
- * @see hook_field_formatter_info_alter().
- * @see hook_field_formatter_view().
- * @see hook_field_formatter_prepare_view().
- *
  * @return
  *   An array describing the formatter types implemented by the module.
  *
@@ -699,6 +696,11 @@
  *   - settings: An array whose keys are the names of the settings available
  *     for the formatter type, and whose values are the default values for
  *     those settings.
+ *
+ * @see hook_field_formatter_info()
+ * @see hook_field_formatter_info_alter()
+ * @see hook_field_formatter_view()
+ * @see hook_field_formatter_prepare_view()
  */
 function hook_field_formatter_info() {
   return array(
@@ -758,7 +760,7 @@
  * which displays properties of the referenced objects such as name or type.
  *
  * This hook is called after the field type's own hook_field_prepare_view().
- * @see hook_field_prepare_view()
+ * See hook_field_prepare_view()
  *
  * Unlike most other field hooks, this hook operates on multiple objects. The
  * $objects, $instances and $items parameters are arrays keyed by object id.
Index: includes/database/database.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/database/database.inc,v
retrieving revision 1.93
diff -u -r1.93 database.inc
--- includes/database/database.inc	25 Jan 2010 10:38:34 -0000	1.93
+++ includes/database/database.inc	28 Jan 2010 20:04:41 -0000
@@ -673,7 +673,6 @@
   /**
    * Prepare and return a SELECT query object with the specified ID.
    *
-   * @see SelectQuery
    * @param $table
    *   The base table for this query, that is, the first table in the FROM
    *   clause. This table will also be used as the "base" table for query_alter
@@ -682,8 +681,11 @@
    *   The alias of the base table of this query.
    * @param $options
    *   An array of options on the query.
+   *
    * @return SelectQueryInterface
    *   A new SelectQuery object.
+   *
+   * @see SelectQuery
    */
   public function select($table, $alias = NULL, array $options = array()) {
     if (empty($this->selectClass)) {
@@ -703,11 +705,11 @@
   /**
    * Prepare and return an INSERT query object with the specified ID.
    *
-   * @see InsertQuery
    * @param $options
    *   An array of options on the query.
    * @return InsertQuery
    *   A new InsertQuery object.
+   * @see InsertQuery
    */
   public function insert($table, array $options = array()) {
     if (empty($this->insertClass)) {
@@ -723,11 +725,13 @@
   /**
    * Prepare and return a MERGE query object with the specified ID.
    *
-   * @see MergeQuery
    * @param $options
    *   An array of options on the query.
+   *
    * @return MergeQuery
    *   A new MergeQuery object.
+   *
+   * @see MergeQuery
    */
   public function merge($table, array $options = array()) {
     if (empty($this->mergeClass)) {
@@ -744,11 +748,13 @@
   /**
    * Prepare and return an UPDATE query object with the specified ID.
    *
-   * @see UpdateQuery
    * @param $options
    *   An array of options on the query.
+   *
    * @return UpdateQuery
    *   A new UpdateQuery object.
+   *
+   * @see UpdateQuery
    */
   public function update($table, array $options = array()) {
     if (empty($this->updateClass)) {
@@ -764,11 +770,13 @@
   /**
    * Prepare and return a DELETE query object with the specified ID.
    *
-   * @see DeleteQuery
    * @param $options
    *   An array of options on the query.
+   *
    * @return DeleteQuery
    *   A new DeleteQuery object.
+   *
+   * @see DeleteQuery
    */
   public function delete($table, array $options = array()) {
     if (empty($this->deleteClass)) {
@@ -784,11 +792,13 @@
   /**
    * Prepare and return a TRUNCATE query object.
    *
-   * @see TruncateQuery
    * @param $options
    *   An array of options on the query.
+   *
    * @return TruncateQuery
    *   A new DeleteQuery object.
+   *
+   * @see TruncateQuery
    */
   public function truncate($table, array $options = array()) {
     if (empty($this->truncateClass)) {
@@ -853,6 +863,7 @@
    *
    * @param $string
    *   The string to escape.
+   *
    * @return
    *   The escaped string.
    */
@@ -892,6 +903,7 @@
    *
    * @param $type
    *   The category to which the rollback message belongs.
+   *
    * @param $message
    *   The message to store in the log. Keep $message translatable
    *   by not concatenating dynamic values into it! Variables in the
@@ -1051,6 +1063,7 @@
    *   The maximum number of result rows to return.
    * @param $options
    *   An array of options on the query.
+   *
    * @return DatabaseStatementInterface
    *   A database query result resource, or NULL if the query was not executed
    *   correctly.
@@ -1086,6 +1099,7 @@
    * @param $options
    *   An associative array of options to control how the query is run. See
    *   the documentation for DatabaseConnection::defaultOptions() for details.
+   *
    * @return
    *   The name of the temporary table.
    */
@@ -1138,11 +1152,13 @@
    * overridable lookup function. Database connections should define only
    * those operators they wish to be handled differently than the default.
    *
-   * @see DatabaseCondition::compile()
    * @param $operator
    *   The condition operator, such as "IN", "BETWEEN", etc. Case-sensitive.
+   *
    * @return
    *   The extra handling directives for the specified operator, or NULL.
+   *
+   * @see DatabaseCondition::compile()
    */
   abstract public function mapConditionOperator($operator);
 
@@ -1172,6 +1188,7 @@
    *   After a database import, it might be that the sequences table is behind,
    *   so by passing in the maximum existing id, it can be assured that we
    *   never issue the same id.
+   *
    * @return
    *   An integer number larger than any number returned by earlier calls and
    *   also larger than the $existing_id if one was passed in.
@@ -1269,15 +1286,17 @@
   /**
    * Start logging a given logging key on the specified connection.
    *
-   * @see DatabaseLog
    * @param $logging_key
    *   The logging key to log.
    * @param $key
    *   The database connection key for which we want to log.
+   *
    * @return DatabaseLog
    *   The query log object. Note that the log object does support richer
    *   methods than the few exposed through the Database class, so in some
    *   cases it may be desirable to access it directly.
+   *
+   * @see DatabaseLog
    */
   final public static function startLog($logging_key, $key = 'default') {
     if (empty(self::$logs[$key])) {
@@ -1299,13 +1318,14 @@
   /**
    * Set a logging callback for notices and errors.
    *
-   * @see watchdog()
    * @param $logging_callback
    *   The function to use as the logging callback.
    * @param $logging_default_severity
    *   The default severity level to use for logged messages.
    * @param $logging_error_severity
    *   The severity level to use for logging error messages.
+   *
+   * @see watchdog()
    */
   final public static function setLoggingCallback($callback, $default_severity, $error_severity) {
     self::$logging_callback = array(
@@ -1335,13 +1355,15 @@
    * it again (which does nothing to an open log key) and call methods on it as
    * desired.
    *
-   * @see DatabaseLog
    * @param $logging_key
    *   The logging key to log.
    * @param $key
    *   The database connection key for which we want to log.
+   *
    * @return array
    *   The query log for the specified logging key and connection.
+   *
+   * @see DatabaseLog
    */
   final public static function getLog($logging_key, $key = 'default') {
     if (empty(self::$logs[$key])) {
@@ -1359,6 +1381,7 @@
    *   The database target name.
    * @param $key
    *   The database connection key. Defaults to NULL which means the active key.
+   *
    * @return DatabaseConnection
    *   The corresponding connection object.
    */
@@ -1737,6 +1760,7 @@
    *   the SQL statement being executed.
    * @param $options
    *   An array of options for this query.
+   *
    * @return
    *   TRUE on success, or FALSE on failure.
    */
@@ -1791,6 +1815,7 @@
    *   Not implemented in all database drivers, don't use.
    * @param $cursor_offset
    *   Not implemented in all database drivers, don't use.
+   *
    * @return
    *   A result, formatted according to $mode.
    */
@@ -1801,6 +1826,7 @@
    *
    * @param $index
    *   The numeric index of the field to return. Defaults to the first field.
+   *
    * @return
    *   A single field from the next record.
    */
@@ -1835,6 +1861,7 @@
    *   If $mode is PDO::FETCH_COLUMN, the index of the column to fetch.
    * @param $constructor_arguments
    *   If $mode is PDO::FETCH_CLASS, the arguments to pass to the constructor.
+   *
    * @return
    *   An array of results.
    */
@@ -1847,6 +1874,7 @@
    *
    * @param $index
    *   The index of the column number to fetch.
+   *
    * @return
    *   An indexed array.
    */
@@ -1866,6 +1894,7 @@
    *   The numeric index of the field to use as the array key.
    * @param $value_index
    *   The numeric index of the field to use as the array value.
+   *
    * @return
    *   An associative array.
    */
@@ -1886,6 +1915,7 @@
    *   The fetchmode to use. If set to PDO::FETCH_ASSOC, PDO::FETCH_NUM, or
    *   PDO::FETCH_BOTH the returned value with be an array of arrays. For any
    *   other value it will be an array of objects.
+   *
    * @return
    *   An associative array.
    */
@@ -2088,7 +2118,6 @@
  * be handled via the appropriate query builder factory. Use this function for
  * SELECT queries that do not require a query builder.
  *
- * @see DatabaseConnection::defaultOptions()
  * @param $query
  *   The prepared statement query to run. Although it will accept both named and
  *   unnamed placeholders, named placeholders are strongly preferred as they are
@@ -2100,8 +2129,11 @@
  *   the order of placeholders in the query string.
  * @param $options
  *   An array of options to control how the query operates.
+ *
  * @return DatabaseStatementInterface
  *   A prepared statement object, already executed.
+ *
+ * @see DatabaseConnection::defaultOptions()
  */
 function db_query($query, array $args = array(), array $options = array()) {
   if (empty($options['target'])) {
@@ -2115,7 +2147,6 @@
  * Execute an arbitrary query string against the active database, restricted to
  * a specified range.
  *
- * @see DatabaseConnection::defaultOptions()
  * @param $query
  *   The prepared statement query to run. Although it will accept both named and
  *   unnamed placeholders, named placeholders are strongly preferred as they are
@@ -2131,8 +2162,11 @@
  *   the order of placeholders in the query string.
  * @param $options
  *   An array of options to control how the query operates.
+ *
  * @return DatabaseStatementInterface
  *   A prepared statement object, already executed.
+ *
+ * @see DatabaseConnection::defaultOptions()
  */
 function db_query_range($query, $from, $count, array $args = array(), array $options = array()) {
   if (empty($options['target'])) {
@@ -2146,7 +2180,6 @@
  * Execute a query string against the active database and save the result set
  * to a temp table.
  *
- * @see DatabaseConnection::defaultOptions()
  * @param $query
  *   The prepared statement query to run. Although it will accept both named and
  *   unnamed placeholders, named placeholders are strongly preferred as they are
@@ -2158,8 +2191,11 @@
  *   the order of placeholders in the query string.
  * @param $options
  *   An array of options to control how the query operates.
+ *
  * @return
  *   The name of the temporary table.
+ *
+ * @see DatabaseConnection::defaultOptions()
  */
 function db_query_temporary($query, array $args = array(), array $options = array()) {
   if (empty($options['target'])) {
@@ -2176,6 +2212,7 @@
  *   The table into which to insert.
  * @param $options
  *   An array of options to control how the query operates.
+ *
  * @return InsertQuery
  *   A new InsertQuery object for this connection.
  */
@@ -2193,6 +2230,7 @@
  *   The table into which to merge.
  * @param $options
  *   An array of options to control how the query operates.
+ *
  * @return MergeQuery
  *   A new MergeQuery object for this connection.
  */
@@ -2210,6 +2248,7 @@
  *   The table to update.
  * @param $options
  *   An array of options to control how the query operates.
+ *
  * @return UpdateQuery
  *   A new UpdateQuery object for this connection.
  */
@@ -2227,6 +2266,7 @@
  *   The table from which to delete.
  * @param $options
  *   An array of options to control how the query operates.
+ *
  * @return DeleteQuery
  *   A new DeleteQuery object for this connection.
  */
@@ -2244,6 +2284,7 @@
  *   The table from which to delete.
  * @param $options
  *   An array of options to control how the query operates.
+ *
  * @return TruncateQuery
  *   A new TruncateQuery object for this connection.
  */
@@ -2264,6 +2305,7 @@
  *   The alias for the base table of this query.
  * @param $options
  *   An array of options to control how the query operates.
+ *
  * @return SelectQuery
  *   A new SelectQuery object for this connection.
  */
@@ -2284,6 +2326,7 @@
  * @param $options
  *   An array of options to control how the transaction operates.  Only the
  *   target key has any meaning in this case.
+ *
  * @return DatabaseTransaction
  *   A new DatabaseTransaction object for this connection.
  */
@@ -2299,6 +2342,7 @@
  *
  * @param $key
  *   The key in the $databases array to set as the default database.
+ *
  * @returns
  *   The key of the formerly active database.
  */
@@ -2327,6 +2371,7 @@
  *
  * @param $table
  *   The table name to escape.
+ *
  * @return
  *   The escaped table name as a string.
  */
@@ -2355,6 +2400,7 @@
  *
  * @param $string
  *   The string to escape.
+ *
  * @return
  *   The escaped string.
  */
@@ -2396,6 +2442,7 @@
  *   After a database import, it might be that the sequences table is behind, so
  *   by passing in a minimum ID, it can be assured that we never issue the same
  *   ID.
+ *
  * @return
  *   An integer number larger than any number returned before for this sequence.
  */
@@ -2436,6 +2483,7 @@
  *
  * @param $fields
  *   An array of key/index column specifiers.
+ *
  * @return
  *   An array of field names.
  */
@@ -2448,6 +2496,7 @@
  *
  * @param $name
  *   Index name.
+ *
  * @return
  *   TRUE if the given index exists, otherwise FALSE.
  */
@@ -2475,6 +2524,7 @@
  * @param $table_expression
  *   An SQL expression, for example "simpletest%" (without the quotes).
  *   BEWARE: this is not prefixed, the caller should take care of that.
+ *
  * @return
  *   Array, both the keys and the values are the matching tables.
  */
@@ -2534,6 +2584,7 @@
  *   without the 'fields' element. If you are adding a type 'serial' field, you
  *   MUST specify at least one key or index including it in this array. See
  *   db_change_field() for more explanation why.
+ *
  * @see db_change_field()
  */
 function db_add_field($table, $field, $spec, $keys_new = array()) {
Index: includes/database/schema.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/database/schema.inc,v
retrieving revision 1.25
diff -u -r1.25 schema.inc
--- includes/database/schema.inc	25 Jan 2010 10:38:34 -0000	1.25
+++ includes/database/schema.inc	28 Jan 2010 20:04:41 -0000
@@ -300,7 +300,7 @@
    *   table along with adding the field. The format is the same as a
    *   table specification but without the 'fields' element. If you are
    *   adding a type 'serial' field, you MUST specify at least one key
-   *   or index including it in this array. @see db_change_field for more
+   *   or index including it in this array. See db_change_field() for more
    *   explanation why.
    */
   abstract public function addField($table, $field, $spec, $keys_new = array());
Index: includes/database/prefetch.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/database/prefetch.inc,v
retrieving revision 1.7
diff -u -r1.7 prefetch.inc
--- includes/database/prefetch.inc	4 Dec 2009 16:31:04 -0000	1.7
+++ includes/database/prefetch.inc	28 Jan 2010 20:04:41 -0000
@@ -89,9 +89,10 @@
 
   /**
    * Holds the current fetch style (which will be used by the next fetch).
-   * @see PDOStatement::fetch()
    *
    * @var int
+   * 
+   * @see PDOStatement::fetch()
    */
   protected $fetchStyle = PDO::FETCH_OBJ;
 
@@ -177,7 +178,6 @@
     $this->data = $statement->fetchAll(PDO::FETCH_ASSOC);
     // Destroy the statement as soon as possible.
     // See DatabaseConnection_sqlite::PDOPrepare() for explanation.
-    // @see DatabaseConnection_sqlite::PDOPrepare()
     unset($statement);
 
     $this->resultRowCount = count($this->data);
Index: modules/search/search.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/search/search.module,v
retrieving revision 1.335
diff -u -r1.335 search.module
--- modules/search/search.module	10 Jan 2010 21:46:16 -0000	1.335
+++ modules/search/search.module	28 Jan 2010 20:04:50 -0000
@@ -8,8 +8,7 @@
 
 /**
  * Matches Unicode character classes to exclude from the search index.
- *
- * @see http://unicode.org/glossary
+ * See http://unicode.org/glossary
  *
  * Characters with the following General_category (gc) property values are
  * excluded from the search index. Also, they are used as word boundaries.
Index: modules/search/search.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/search/search.api.php,v
retrieving revision 1.23
diff -u -r1.23 search.api.php
--- modules/search/search.api.php	25 Jan 2010 10:38:34 -0000	1.23
+++ modules/search/search.api.php	28 Jan 2010 20:04:50 -0000
@@ -218,8 +218,8 @@
  * theme('search_result') work together to create a definition
  * list. So your hook_search_page() implementation should probably do
  * this as well.
- *
- * @see search-result.tpl.php, search-results.tpl.php
+ * See search-result.tpl.php
+ * See search-results.tpl.php
  *
  * @param $results
  *   An array of search results.
Index: modules/trigger/trigger.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/trigger/trigger.api.php,v
retrieving revision 1.5
diff -u -r1.5 trigger.api.php
--- modules/trigger/trigger.api.php	19 Sep 2009 11:07:36 -0000	1.5
+++ modules/trigger/trigger.api.php	28 Jan 2010 20:04:59 -0000
@@ -20,8 +20,6 @@
  * out which actions the user has associated with your trigger, and then calling
  * actions_do() to fire off the actions.
  *
- * @see hook_action_info().
- *
  * @return
  *   A nested associative array.
  *   - The outermost key is the name of the module that is defining the triggers.
@@ -38,6 +36,8 @@
  *   For example, the trigger set for the 'node' module has 'node' as the
  *   outermost key and defines triggers for 'node_insert', 'node_update',
  *   'node_delete' etc. that fire when a node is saved, updated, etc.
+ *
+ * @see hook_action_info()
  */
 function hook_trigger_info() {
   return array(
Index: modules/field/tests/field.test
===================================================================
RCS file: /cvs/drupal/drupal/modules/field/tests/field.test,v
retrieving revision 1.12
diff -u -r1.12 field.test
--- modules/field/tests/field.test	13 Jan 2010 05:08:29 -0000	1.12
+++ modules/field/tests/field.test	28 Jan 2010 20:04:46 -0000
@@ -17,7 +17,7 @@
    */
   function setUp() {
     // Call parent::setUp().
-    // @see http://www.php.net/manual/en/function.call-user-func-array.php#73105
+    // See http://www.php.net/manual/en/function.call-user-func-array.php#73105
     $args = func_get_args();
     call_user_func_array(array($this, 'parent::setUp'), $args);
     // Set default storage backend.
Index: modules/taxonomy/taxonomy.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/taxonomy/taxonomy.module,v
retrieving revision 1.569
diff -u -r1.569 taxonomy.module
--- modules/taxonomy/taxonomy.module	25 Jan 2010 17:04:03 -0000	1.569
+++ modules/taxonomy/taxonomy.module	28 Jan 2010 20:04:59 -0000
@@ -866,8 +866,6 @@
  * from the database. Terms are loaded into memory and will not require
  * database access if loaded again during the same page request.
  *
- * @see entity_load()
- *
  * @param $tids
  *  An array of taxonomy term IDs.
  * @param $conditions
@@ -875,6 +873,8 @@
  *
  * @return
  *  An array of term objects, indexed by tid.
+ *
+ * @see entity_load()
  */
 function taxonomy_term_load_multiple($tids = array(), $conditions = array()) {
   return entity_load('taxonomy_term', $tids, $conditions);
@@ -887,8 +887,6 @@
  * vocabulary from the database. Terms are loaded into memory and will not
  * require database access if loaded again during the same page request.
  *
- * @see entity_load()
- *
  * @param $vids
  *  An array of taxonomy vocabulary IDs, or FALSE to load all vocabularies.
  * @param $conditions
@@ -896,6 +894,8 @@
  *
  * @return
  *  An array of vocabulary objects, indexed by vid.
+ *
+ * @see entity_load()
  */
 function taxonomy_vocabulary_load_multiple($vids = array(), $conditions = array()) {
   return entity_load('taxonomy_vocabulary', $vids, $conditions);
Index: modules/comment/comment.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/comment/comment.module,v
retrieving revision 1.837
diff -u -r1.837 comment.module
--- modules/comment/comment.module	14 Jan 2010 02:00:08 -0000	1.837
+++ modules/comment/comment.module	28 Jan 2010 20:04:43 -0000
@@ -913,7 +913,7 @@
   //   The goal is for theme('field') to be sufficiently optimized prior to
   //   Drupal 7 release, so that this code can be removed, and the comment body
   //   can be rendered just like all other fields. Otherwise, another solution
-  //   to the above problems will be needed. @see http://drupal.org/node/659788.
+  //   to the above problems will be needed. See http://drupal.org/node/659788.
   if (isset($comment->content['comment_body']['#theme']) && ($comment->content['comment_body']['#theme'] === 'field')) {
     unset($comment->content['comment_body']['#theme']);
   }
@@ -1665,7 +1665,7 @@
   else {
     // For threaded comments, the c.thread column is used for ordering. We can
     // use the vancode for comparison, but must remove the trailing slash.
-    // @see comment_view_multiple().
+    // See comment_view_multiple().
     $query->where('SUBSTRING(c1.thread, 1, (LENGTH(c1.thread) -1)) < SUBSTRING(c2.thread, 1, (LENGTH(c2.thread) -1))');
   }
 
Index: modules/update/update.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/update/update.module,v
retrieving revision 1.61
diff -u -r1.61 update.module
--- modules/update/update.module	14 Jan 2010 02:17:46 -0000	1.61
+++ modules/update/update.module	28 Jan 2010 20:05:00 -0000
@@ -617,10 +617,10 @@
  * @param $variables
  *   'last': The timestamp when the site last checked for available updates.
  *
+ * @ingroup themeable
+ *
  * @see theme_update_report()
  * @see theme_update_available_updates_form()
- *
- * @ingroup themeable
  */
 function theme_update_last_check($variables) {
   $last = $variables['last'];
Index: modules/rdf/rdf.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/rdf/rdf.module,v
retrieving revision 1.21
diff -u -r1.21 rdf.module
--- modules/rdf/rdf.module	22 Jan 2010 22:55:03 -0000	1.21
+++ modules/rdf/rdf.module	28 Jan 2010 20:04:50 -0000
@@ -26,7 +26,7 @@
  *
  * RDF module introduces RDFa to Drupal, which provides a set of XHTML
  * attributes to augment visual data with machine-readable hints.
- * @see http://www.w3.org/TR/xhtml-rdfa-primer/
+ * See http://www.w3.org/TR/xhtml-rdfa-primer/
  *
  * Modules can provide mappings of their bundles' data and metadata to RDFa
  * properties using the appropriate vocabularies. This module takes care of
@@ -268,7 +268,7 @@
  */
 function rdf_modules_installed($modules) {
   // We need to clear the caches of entity_info as this is not done right
-  // during the tests. see http://drupal.org/node/594234
+  // during the tests. See http://drupal.org/node/594234.
   entity_info_cache_clear();
 
   foreach ($modules as $module) {
@@ -352,7 +352,7 @@
   // Handles attributes needed for content not covered by title, content,
   // and field items. Does this by adjusting the variable sent to the template
   // so that the template doesn't have to worry about it.
-  // @see theme_rdf_template_variable_wrapper()
+  // See theme_rdf_template_variable_wrapper()
   if (!empty($variables['rdf_template_variable_attributes_array'])) {
     foreach ($variables['rdf_template_variable_attributes_array'] as $variable_name => $attributes) {
       $context = array(
@@ -666,9 +666,9 @@
  *   drupal_attributes($rdf_template_variable_attributes_array[$variable_name])
  * @endcode
  *
- * @see rdf_process()
- *
  * @ingroup themeable
+ *
+ * @see rdf_process()
  */
 function theme_rdf_template_variable_wrapper($variables) {
   $output = $variables['content'];
@@ -697,9 +697,9 @@
  * @return
  *   A string of HTML containing markup that can be understood by RDFa parsers.
  *
- * @see rdf_process()
- *
  * @ingroup themeable
+ *
+ * @see rdf_process()
  */
 function theme_rdf_metadata($variables) {
   $output = '';
Index: includes/filetransfer/filetransfer.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/filetransfer/filetransfer.inc,v
retrieving revision 1.8
diff -u -r1.8 filetransfer.inc
--- includes/filetransfer/filetransfer.inc	25 Jan 2010 10:38:34 -0000	1.8
+++ includes/filetransfer/filetransfer.inc	28 Jan 2010 20:04:41 -0000
@@ -66,11 +66,11 @@
   }
 
   /**
-   * @see http://php.net/chmod
-   *
    * @param string $path
    * @param long $mode
    * @param bool $recursive
+   * 
+   * @see http://php.net/chmod
    */
   public final function chmod($path, $mode, $recursive = FALSE) {
     if (!in_array('FileTransferChmodInterface', class_implements(get_class($this)))) {
@@ -330,7 +330,7 @@
    * @param string $path
    *   Path to change permissions of.
    * @param long $mode
-   *   @see http://php.net/chmod
+   *   See http://php.net/chmod
    * @param boolean $recursive
    *   Pass TRUE to recursively chmod the entire directory specified in $path.
    */
Index: modules/node/tests/node_test.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/node/tests/node_test.module,v
retrieving revision 1.9
diff -u -r1.9 node_test.module
--- modules/node/tests/node_test.module	26 Dec 2009 16:50:09 -0000	1.9
+++ modules/node/tests/node_test.module	28 Jan 2010 20:04:49 -0000
@@ -40,7 +40,7 @@
 function node_test_node_grants($account, $op) {
   // Give everyone full grants so we don't break other node tests.
   // Our node access tests asserts three realms of access.
-  // @see testGrantAlter()
+  // See testGrantAlter()
   return array(
     'test_article_realm' => array(1),
     'test_page_realm' => array(1),