| Subject: | Documentation bug re -newstyle_urls |
| Date: | Sat, 5 Sep 2009 20:50:19 -0700 |
| To: | bug-CGI.pm [...] rt.cpan.org |
| From: | Ryan Tate <ryantate [...] ryantate.com> |
The documentation for the -newstyle_urls pragmas includes the
following snippet, which is misleading at best:
"Semicolon-delimited query strings are always accepted, but will not
be emitted by self_url() and query_string() unless the -newstyle_urls
pragma is specified. This became the default in version 2.64."
In fact, semicolon-delimited query strings *are* emitted even
*without* of the -newstyle_urls pragma being specified. This is
implied subtly in the second sentence -- it's the default, so you
don't have to specify it any more -- but in any case the first
sentence is itself incorrect due to the "unless... specified" bit.
Better would be something like this:
"Semicolon-delimited query strings are always accepted, but will only
be emitted by self_url() and query_string() if the -newstyle_urls
pragma is in effect. It is in effect by default starting with version
2.64."