Various minor doc fixes

WordPress/AbstractFunctionParameterSniff.php

@@ -60,7 +60,7 @@ public function getGroups() {
 	 * Process a matched token.
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 *
 	 * @return int|void Integer stack pointer to skip forward or void to continue
@@ -83,7 +83,7 @@ public function process_matched_token( $stackPtr, $group_name, $matched_content
 	 * This method has to be made concrete in child classes.
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *
@@ -99,7 +99,7 @@ abstract public function process_parameters( $stackPtr, $group_name, $matched_co
 	 * were parameters are expected, but none found.
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 *
 	 * @return int|void Integer stack pointer to skip forward or void to continue

WordPress/Sniffs/Arrays/ArrayIndentationSniff.php

@@ -85,7 +85,8 @@ public function register() {
 	 *
 	 * @param int $stackPtr The position of the current token in the stack.
 	 *
-	 * @return void
+	 * @return int|void Integer stack pointer to skip forward or void to continue
+	 *                  normal file processing.
 	 */
 	public function process_token( $stackPtr ) {
 		if ( ! isset( $this->tab_width ) ) {

WordPress/Sniffs/CodeAnalysis/EmptyStatementSniff.php

@@ -48,7 +48,8 @@ public function register() {
 	 *
 	 * @param int $stackPtr The position of the current token in the stack.
 	 *
-	 * @return int Integer stack pointer to skip the rest of the file.
+	 * @return int|void Integer stack pointer to skip forward or void to continue
+	 *                  normal file processing.
 	 */
 	public function process_token( $stackPtr ) {
 

WordPress/Sniffs/CodeAnalysis/EscapedNotTranslatedSniff.php

@@ -55,7 +55,7 @@ class EscapedNotTranslatedSniff extends AbstractFunctionParameterSniff {
 	 * @since 2.2.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *

WordPress/Sniffs/DB/DirectDatabaseQuerySniff.php

@@ -109,7 +109,8 @@ public function register() {
 	 *
 	 * @param int $stackPtr The position of the current token in the stack.
 	 *
-	 * @return void
+	 * @return int|void Integer stack pointer to skip forward or void to continue
+	 *                  normal file processing.
 	 */
 	public function process_token( $stackPtr ) {
 

WordPress/Sniffs/NamingConventions/PrefixAllGlobalsSniff.php

@@ -722,7 +722,7 @@ protected function process_variable_assignment( $stackPtr ) {
 	 * @since 0.12.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *

WordPress/Sniffs/NamingConventions/ValidHookNameSniff.php

@@ -82,7 +82,7 @@ public function getGroups() {
 	 * @since 0.11.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *

WordPress/Sniffs/PHP/IniSetSniff.php

@@ -129,7 +129,7 @@ class IniSetSniff extends AbstractFunctionParameterSniff {
 	 * @since 2.1.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *

WordPress/Sniffs/PHP/PregQuoteDelimiterSniff.php

@@ -48,7 +48,7 @@ class PregQuoteDelimiterSniff extends AbstractFunctionParameterSniff {
 	 * @since 1.0.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *

WordPress/Sniffs/PHP/StrictInArraySniff.php

@@ -66,7 +66,7 @@ class StrictInArraySniff extends AbstractFunctionParameterSniff {
 	 * @since 0.11.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *

WordPress/Sniffs/Security/PluginMenuSlugSniff.php

@@ -68,7 +68,7 @@ class PluginMenuSlugSniff extends AbstractFunctionParameterSniff {
 	 * @since 0.11.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *

WordPress/Sniffs/Utils/I18nTextDomainFixerSniff.php

@@ -354,7 +354,7 @@ public function process_token( $stackPtr ) {
 	 * @since 1.2.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *
@@ -462,7 +462,7 @@ public function process_parameters( $stackPtr, $group_name, $matched_content, $p
 	 * @since 1.2.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 *
 	 * @return void
@@ -532,7 +532,8 @@ public function process_no_parameters( $stackPtr, $group_name, $matched_content
 	 *
 	 * @param int $stackPtr The position of the current token in the stack.
 	 *
-	 * @return void
+	 * @return int|void Integer stack pointer to skip forward or void to continue
+	 *                  normal file processing.
 	 */
 	public function process_comments( $stackPtr ) {
 		if ( true === $this->header_found && ! defined( 'PHP_CODESNIFFER_IN_TESTS' ) ) {

WordPress/Sniffs/WP/DeprecatedClassesSniff.php

@@ -71,8 +71,8 @@ public function getGroups() {
 	 * Process a matched token.
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched. Will
-	 *                                always be 'deprecated_functions'.
+	 * @param string $group_name      The name of the group which was matched. Will
+	 *                                always be 'deprecated_classes'.
 	 * @param string $matched_content The token content (class name) which was matched.
 	 *
 	 * @return void

WordPress/Sniffs/WP/DeprecatedFunctionsSniff.php

@@ -1367,7 +1367,7 @@ public function getGroups() {
 	 * Process a matched token.
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched. Will
+	 * @param string $group_name      The name of the group which was matched. Will
 	 *                                always be 'deprecated_functions'.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 *

WordPress/Sniffs/WP/DeprecatedParameterValuesSniff.php

@@ -143,7 +143,7 @@ class DeprecatedParameterValuesSniff extends AbstractFunctionParameterSniff {
 	 * @since 1.0.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *

WordPress/Sniffs/WP/DeprecatedParametersSniff.php

@@ -271,7 +271,7 @@ class DeprecatedParametersSniff extends AbstractFunctionParameterSniff {
 	 * @since 0.12.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *

WordPress/Sniffs/WP/DiscouragedConstantsSniff.php

@@ -184,7 +184,7 @@ public function process_arbitrary_tstring( $stackPtr ) {
 	 * @since 0.14.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *

WordPress/Sniffs/WP/EnqueuedResourceParametersSniff.php

@@ -111,7 +111,7 @@ public function register() {
 	 * @since 1.0.0
 	 *
 	 * @param int    $stackPtr        The position of the current token in the stack.
-	 * @param array  $group_name      The name of the group which was matched.
+	 * @param string $group_name      The name of the group which was matched.
 	 * @param string $matched_content The token content (function name) which was matched.
 	 * @param array  $parameters      Array with information about the parameters.
 	 *

WordPress/Sniffs/WP/GlobalVariablesOverrideSniff.php

@@ -31,7 +31,7 @@ class GlobalVariablesOverrideSniff extends Sniff {
 
 	/**
 	 * Whether to treat all files as if they were included from
-	 * a within function.
+	 * within a function.
 	 *
 	 * This is mostly useful for projects containing views which are being
 	 * included from within a function in another file, like themes.

WordPress/Sniffs/WhiteSpace/CastStructureSpacingSniff.php

@@ -13,7 +13,7 @@
 use PHP_CodeSniffer\Util\Tokens;
 
 /**
- * Ensure cast statements don't contain whitespace, but *are* surrounded by whitespace, based upon Squiz code.
+ * Ensure cast statements are preceded by whitespace.
  *
  * @link    https://make.wordpress.org/core/handbook/best-practices/coding-standards/php/#space-usage
  *
@@ -24,6 +24,8 @@
  * @since   0.11.0 The error level for all errors thrown by this sniff has been raised from warning to error.
  * @since   0.12.0 This class now extends the WordPressCS native `Sniff` class.
  * @since   0.13.0 Class name changed: this class is now namespaced.
+ * @since   1.2.0  Removed the `NoSpaceAfterCloseParenthesis` error code in favour of the
+ *                 upstream `Generic.Formatting.SpaceAfterCast.NoSpace` error.
  * @since   2.2.0  Added exception for whitespace between spread operator and cast.
  */
 class CastStructureSpacingSniff extends Sniff {