Subject: | Needs peer review: docs for query_string should be updated |
The docs for the query_string() method currently say this:
"You can also retrieve the unprocessed query string with query_string()"
However, I think the "unprocessed" bit is not true. I think the
unprocessed query string would be $ENV{QUERY_STRING}. Instead, what
query_string() is to build a query string based on the *processed* query
string each time. Then a newly constructed query string is emitted, with
your choice of semicolon or ampersand delimiters, regardless of what an
input query string may have had.
I recommend these docs be updated as follows:
"You can also retrieve a query string representation of the current
object state with query_string()"
I'd like someone else to peer review this change and provide an opinion
on the issue.