missing documentation for changes to $form_state['redirect'] structure

ok, after further investigation, the core code is correct, it's the upgrade documentation that's busted ;)

a search of http://drupal.org/update/modules/6/7 for both 'form' and 'redirect' doesn't yield any information about the change to the format of $form_state['redirect']. the upgrade doc should probably go something like this:

the format of $form_state['redirect'] has changed. it is now a numerically indexed array, the first element is the path, and the second element is an array of options that url() can take.

example:

6.x

  $form_state['redirect'] = array(
    'path' => 'foo',
    'query' => 'bar',
    'fragment' => 'baz',
  );

7.x

  $form_state['redirect'] = array(
    'foo',
    array(
      'query' => 'bar',
      'fragment' => 'baz',
    ),
  );