fix comments formatting

Author: aristath

wp-includes/sqlite/class-wp-sqlite-lexer.php

@@ -1321,8 +1321,11 @@ class WP_SQLite_Lexer {
 	 * @var array<string, bool|int|array<int, int|string|array<string, bool>>>
 	 */
 	public static $field_options = array(
-		// Tells the `OptionsArray` to not sort the options.
-		// See the note below.
+
+		/*
+		 * Tells the `OptionsArray` to not sort the options.
+		 * See the note below.
+		 */
 		'_UNSORTED'        => true,
 
 		'NOT NULL'         => 1,
@@ -1535,8 +1538,10 @@ public function lex() {
 					continue;
 				}
 
-				// Skipping last R (from `delimiteR`) and whitespaces between
-				// the keyword `DELIMITER` and the actual delimiter.
+				/*
+				 * Skipping last R (from `delimiteR`) and whitespaces between
+				 * the keyword `DELIMITER` and the actual delimiter.
+				 */
 				$pos   = ++$this->last;
 				$token = $this->parse_whitespace();
 
@@ -1725,16 +1730,10 @@ public function parse_keyword() {
 		 */
 		$ret = null;
 
-		/**
-		 * The value of `$this->last` where `$token` ends in `$this->str`.
-		 */
+		// The value of `$this->last` where `$token` ends in `$this->str`.
 		$i_end = $this->last;
 
-		/**
-		 * Whether last parsed character is a whitespace.
-		 *
-		 * @var bool
-		 */
+		// Whether last parsed character is a whitespace.
 		$last_space = false;
 
 		for ( $j = 1; $j < static::KEYWORD_MAX_LENGTH && $this->last < $this->string_length; ++$j, ++$this->last ) {
@@ -1786,9 +1785,7 @@ public function parse_label() {
 		 */
 		$ret = null;
 
-		/**
-		 * The value of `$this->last` where `$token` ends in `$this->str`.
-		 */
+		// The value of `$this->last` where `$token` ends in `$this->str`.
 		$i_end = $this->last;
 		for ( $j = 1; $j < static::LABEL_MAX_LENGTH && $this->last < $this->string_length; ++$j, ++$this->last ) {
 			if ( ':' === $this->str[ $this->last ] && $j > 1 ) {
@@ -1800,8 +1797,10 @@ public function parse_label() {
 			}
 
 			if ( static::is_whitespace( $this->str[ $this->last ] ) && $j > 1 ) {
-				// Whitespace between label and `:`.
-				// The size of the keyword didn't increase.
+				/*
+				 * Whitespace between label and `:`.
+				 * The size of the keyword didn't increase.
+				 */
 				--$j;
 			} elseif ( static::is_separator( $this->str[ $this->last ] ) ) {
 				// Any other separator.
@@ -1831,9 +1830,7 @@ public function parse_operator() {
 		 */
 		$ret = null;
 
-		/**
-		 * The value of `$this->last` where `$token` ends in `$this->str`.
-		 */
+		// The value of `$this->last` where `$token` ends in `$this->str`.
 		$i_end = $this->last;
 
 		for ( $j = 1; $j < static::OPERATOR_MAX_LENGTH && $this->last < $this->string_length; ++$j, ++$this->last ) {
@@ -2504,8 +2501,10 @@ public static function is_string( $str ) {
 	 * @return bool
 	 */
 	public static function is_separator( $str ) {
-		// NOTES:   Only non alphanumeric ASCII characters may be separators.
-		// `~` is the last printable ASCII character.
+		/*
+		 * NOTES:   Only non alphanumeric ASCII characters may be separators.
+		 * `~` is the last printable ASCII character.
+		 */
 		return ( $str <= '~' )
 			&& ( '_' !== $str )
 			&& ( '$' !== $str )

wp-includes/sqlite/class-wp-sqlite-query-rewriter.php

@@ -238,8 +238,10 @@ public function skip( $query = array() ) {
 	public function skip_and_return_all( $query = array() ) {
 		$tokens = $this->move_forward( $query );
 
-		// When skipping over whitespaces, make sure to consume
-		// at least one to avoid SQL syntax errors.
+		/*
+		 * When skipping over whitespaces, make sure to consume
+		 * at least one to avoid SQL syntax errors.
+		 */
 		foreach ( $tokens as $token ) {
 			if ( $token->matches( WP_SQLite_Token::TYPE_WHITESPACE ) ) {
 				$this->add( $token );

wp-includes/sqlite/class-wp-sqlite-token.php

@@ -17,8 +17,6 @@
  */
 class WP_SQLite_Token {
 
-	// Types of tokens (a vague description of a token's purpose).
-
 	/**
 	 * This type is used when the token is invalid or its type cannot be
 	 * determined because of the ambiguous context. Further analysis might be
@@ -248,8 +246,10 @@ private function extract() {
 			case self::TYPE_KEYWORD:
 				$this->keyword = strtoupper( $this->token );
 				if ( ! ( $this->flags & self::FLAG_KEYWORD_RESERVED ) ) {
-					// Unreserved keywords should stay the way they are because they
-					// might represent field names.
+					/*
+					 * Unreserved keywords should stay the way they are
+					 * because they might represent field names.
+					 */
 					return $this->token;
 				}
 
@@ -287,19 +287,23 @@ private function extract() {
 				$quote = $this->token[0];
 				$str   = str_replace( $quote . $quote, $quote, $str );
 
-				// Finally unescapes the string.
-				//
-				// `stripcslashes` replaces escape sequences with their
-				// representation.
+				/*
+				 * Finally unescapes the string.
+				 *
+				 * `stripcslashes` replaces escape sequences with their
+				 * representation.
+				 */
 				$str = stripcslashes( $str );
 
 				return $str;
 
 			case self::TYPE_SYMBOL:
 				$str = $this->token;
 				if ( isset( $str[0] ) && ( '@' === $str[0] ) ) {
-					// `mb_strlen($str)` must be used instead of `null` because
-					// in PHP 5.3- the `null` parameter isn't handled correctly.
+					/*
+					 * `mb_strlen($str)` must be used instead of `null` because
+					 * in PHP 5.3- the `null` parameter isn't handled correctly.
+					 */
 					$str = mb_substr(
 						$str,
 						! empty( $str[1] ) && ( '@' === $str[1] ) ? 2 : 1,