docs: change @param to @phpstan-param

kenjis · kenjis · commit d21c65d1a8ef · 2022-10-20T16:43:32.000+09:00
It seems PhpStorm does not support `@param 'html'`.
diff --git a/system/Common.php b/system/Common.php
@@ -415,10 +415,10 @@ function env(string $key, $default = null)
      * 'value' of the key/value pairs.
      *
      * @param array|string $data
-     * @param 'html'|'js'|'css'|'url'|'attr'|'raw' $context
-     * @param string|null  $encoding Current encoding for escaping.
-     *                               If not UTF-8, we convert strings from this encoding
-     *                               pre-escaping and back to this encoding post-escaping.
+     * @phpstan-param 'html'|'js'|'css'|'url'|'attr'|'raw' $context
+     * @param string|null $encoding Current encoding for escaping.
+     *                              If not UTF-8, we convert strings from this encoding
+     *                              pre-escaping and back to this encoding post-escaping.
      *
      * @return array|string
      *

Original file line number	Diff line number	Diff line change
`@@ -415,10 +415,10 @@ function env(string $key, $default = null)`
`415`	`415`	`* 'value' of the key/value pairs.`
`416`	`416`	`*`
`417`	`417`	`* @param array\|string $data`
`418`		`- * @param 'html'\|'js'\|'css'\|'url'\|'attr'\|'raw' $context`
`419`		`- * @param string\|null $encoding Current encoding for escaping.`
`420`		`- * If not UTF-8, we convert strings from this encoding`
`421`		`- * pre-escaping and back to this encoding post-escaping.`
	`418`	`+ * @phpstan-param 'html'\|'js'\|'css'\|'url'\|'attr'\|'raw' $context`
	`419`	`+ * @param string\|null $encoding Current encoding for escaping.`
	`420`	`+ * If not UTF-8, we convert strings from this encoding`
	`421`	`+ * pre-escaping and back to this encoding post-escaping.`
`422`	`422`	`*`
`423`	`423`	`* @return array\|string`
`424`	`424`	`*`