|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."