Clean up inline comments and tighten wording

Inline comments should read as complete sentences and be easy to scan. Ending
each comment with a full stop signals that the thought is complete and keeps
the style consistent across the codebase. Where comments were verbose or
imprecise, take the opportunity to tighten the wording without changing
meaning.

Author: lippserd

src/Filter.php

@@ -231,10 +231,10 @@ protected function performEqualityMatch(mixed $value, mixed $rowValue, bool $ign
     {
         if ($ignoreCase && is_string($rowValue)) {
             $rowValue = strtolower($rowValue);
-            /** @var string|string[] $value {@see self::normalizeTypes} ensures this is the case */
+            /** @var string|string[] $value {@link self::normalizeTypes} ensures this is the case */
             $value = is_array($value)
                 ? array_map('strtolower', $value)
-                : ($value === null ? null : strtolower($value)); // phpstan is wrong here
+                : ($value === null ? null : strtolower($value)); // PHPStan incorrectly infers the type here.
         }
 
         if (is_array($value)) {
@@ -257,10 +257,10 @@ protected function performSimilarityMatch(mixed $value, mixed $rowValue, bool $i
     {
         if ($ignoreCase && is_string($rowValue)) {
             $rowValue = strtolower($rowValue);
-            /** @var string|string[] $value {@see self::normalizeTypes} ensures this is the case */
+            /** @var string|string[] $value {@link self::normalizeTypes} ensures this is the case */
             $value = is_array($value)
                 ? array_map('strtolower', $value)
-                : ($value === null ? null : strtolower($value)); // phpstan is wrong here
+                : ($value === null ? null : strtolower($value)); // PHPStan incorrectly infers the type here.
         }
 
         if (is_array($value)) {

src/PriorityQueue.php

@@ -37,7 +37,7 @@ public function insert(mixed $value, mixed $priority): true
      */
     public function yieldAll(): Generator
     {
-        // Clone queue because the SplPriorityQueue acts as a heap and thus items are removed upon iteration
+        // Clone the queue because SplPriorityQueue acts as a heap and removes items upon iteration.
         $queue = clone $this;
 
         $queue->setExtractFlags(static::EXTR_BOTH);

src/functions.php

@@ -43,7 +43,7 @@ function arrayval(iterable|stdClass $subject): array
         return (array) $subject;
     }
 
-    // Works for generators too
+    // Also works for generators.
     return iterator_to_array($subject);
 }
 

src/functions_include.php

@@ -1,6 +1,6 @@
 <?php
 
-// Don't redefine the functions if included multiple times
+// Do not redefine the functions if this file is included multiple times.
 if (! function_exists('ipl\Stdlib\get_php_type')) {
     require __DIR__ . '/functions.php';
 }