docs: fix @param in Common

kenjis · kenjis · commit dd16833a7446 · 2022-10-20T16:43:31.000+09:00
diff --git a/system/Common.php b/system/Common.php
@@ -414,10 +414,11 @@ function env(string $key, $default = null)
      * If $data is an array, then it loops over it, escaping each
      * 'value' of the key/value pairs.
      *
-     * Valid context values: html, js, css, url, attr, raw
-     *
      * @param array|string $data
-     * @param string       $encoding
+     * @param string       $context  Valid context values: html, js, css, url, attr, raw
+     * @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
`@@ -414,10 +414,11 @@ function env(string $key, $default = null)`
`414`	`414`	`* If $data is an array, then it loops over it, escaping each`
`415`	`415`	`* 'value' of the key/value pairs.`
`416`	`416`	`*`
`417`		`- * Valid context values: html, js, css, url, attr, raw`
`418`		`- *`
`419`	`417`	`* @param array\|string $data`
`420`		`- * @param string $encoding`
	`418`	`+ * @param string $context Valid context values: html, js, css, url, attr, raw`
	`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.`
`421`	`422`	`*`
`422`	`423`	`* @return array\|string`
`423`	`424`	`*`