Webhelpers

------------------
* Delete deprecated subpackage: rails.
These are replaced by new helpers in date, html, misc, number, text.
* Delete other deprecated subpackages: commands, hinclude, htmlgen, pagination.
Pagination is replaced by paginate.
* webhelpers.constants:

- ``uk_counties`` returns tuples rather than strings.

* webhelpers.feedgenerator:

- ``rfc3339_date`` now accepts date objects without crashing.
- Add 'generator' and 'source' properties to RSS2 feeds. Patch by
Vince Spicer. (Removed in 1.0b2 due to bugs.)
- Add 'published' property to Atom1 feeds.

* webhelpers.html.converters:

- New helper ``render()`` formats HTML to text.
- New helper ``sanitize()`` strips HTML tags from user input.

* webhelprs.html.tags:

- New helper ``css_classes()`` to add classes to a tag programmatically.
- Fix bug in tag helpers when passing ``id_`` argument (although ``id`` is
recommended instead).
- Add OptionGroup class and optgroup support to select(). Patch by
Alexandre Bourget.

* webhelpers.html.tools:

- New helper ``strip_tags()`` deletes HTML tags in a string.

* webhelpers.paginate:

- Allow all versions of SQLAlchemy > 0.3.
- convert "_range" and "_pagelink" function to Page class method so that they
can be overridden
- pager "onclick" argument use template string value. So, javascript code can
use "partial_url" or "page" value or any. Backward compatibility is
considered.
- Add presliced list option to avoid slicing when list is already.

* webhelpers.pylonslib:

- is now a package.
- The ``Flash`` class now accepts severity categories, thanks to Wichert
Akkerman. The docstring shows how to set up auto-fading messages using
Javascript a la Mac OSX's "Growl" feature. This is backward compatible
although you should delete existing sessions when upgrading from 0.6.x.
- ``webhelpers.pylonslib.minify`` contains enhanced versions of
``javascript_link`` and ``stylesheet_link`` to minify (shrink) files for
more efficient transmission. (EXPERIMENTAL: tests fail in
unfinished/disabled_test_pylonslib_minify.py; see
http://pylonshq.com/project/pylonshq/ticket/466 .)

* webhelpers.text:

- Port several helpers from Ruby's "stringex" package.

+ ``urlify()`` converts any string to a URL-friendly equivalent.
+ ``remove_formatting()``.
+ If the ``unidecode`` package is installed, these two helpers will also
transliterate non-ASCII characters to their closest pronounciation
equvivalent in ASCII.
+ Four other helpers reduce HTML entities or whitespace.

-----------------
* text(), password(), checkbox(), textarea(), and select() have a
magic 'id attribute. If not specified it defaults to the name. To suppress
the ID entirely, pass ``id=""``. This is to help set the ID for title().
radio() doesn't do this because it generates the ID another way. hidden()
doesn't because hidden fields aren't used with labels.
* Bugfixes in mt.select():

- selected values not being passed as list.
- allow currently-selected value to be a long.

* Delete experimental module webhelpers.html.form_layout.

-----------------
* Bugfix in distribute() found by Randy Syring.
* New helpers title() and required_legend() in webhelpers.html.tags.
* New directory webhelpers/public for static files
* Suggested stylesheet webhelpers/public/stylesheets/webhelpers.css
(You'll have to manually add this to your application.)

-----------------
* nl2br() and format-paragraphs were not literal-safe.
* webhelpers.converters:

- New helper transpose() to turn a 2D list sideways (making the rows columns
and the columns rows).

* webhelpers.markdown:

- Upgrade to Markdown 1.7.
- Add a warning about escaping untrusted HTML to
webhelpers.html.converters.markdown() docstring.
- Did not include Markdown's extensions due to relative import issues.
Use the full Markdown package if you want footnotes or RSS.

* webhelpers.media:

- New module for muiltimedia helpers. Initial functions determine the size
of an image and choose a scaling factor.

* webhelpers.html.tags:

- Options tuple contains Option objects for select/checkbox/radio groups.
select() now uses this automatically.
- checkbox() and radio() now have a ``label`` argument.

* webhelpers.number:

- Population standard deviation contributed by Lorenzo Catucci.

* webhelpers.html.form_layout: form field layout (PRELIMINARY, UNSTABLE).

-----------------
* Include a faster version of cgi.escape for use by the literal object.
* Fixed bug in SimplerXMLGenerator that the FeedGenerator uses, so that
it doesn't use a {} arg.
* New helpers:

- nl2br() and format_paragraphs() in webhelpers.html.converters.
- ul() and ol() in webhelpers.html.tags.
- series() in webhelpers.text.

* HTML.tag() is a synonym for make_tag(), both in webhelpers.html.builder.
* Change default form method to "post" (rather than "POST") to conform to XHTML.
* Add DeprecationWarning for webhelpers.rails package,
webhelpers.rails.url_for(), and webhelpers.pagination.

----------------
* Add webhelpers.html.builder to generate HTML tags with smart escaping,
along with a literal type to mark preformatted strings.
* Deprecate webhelpers.rails, including its Javascript libraries (Prototype
and Scriptaculous). Wrap all rails helpers in a literal.
* Many new modules:

- constants - countries, states, and provinces.
- containers - high-level collections, including flash messages.
- date - date/time (rails replacement).
- html.converters - text-to-HTML (rails replacement).
- html.tags - HTML tags (rails replacement).
- html.tools - larger HTML chunks (rails replacement).
- mail - sending email.
- misc - helpers that are neither text, numeric, container, nor date.
- number - numeric helpers and number formatters.
- paginate - successor to deprecated pagination module.
- text - non-HTML text formatting (rails replacement).

* Removed dependency on simplejson and normalized quotes. Patch by Elisha
Cook.

COMPATIBILITY CHANGES IN 0.6 DEV VERSION
----------------------------------------
* image(), javascript_link(), stylesheet_link(), and auto_discovery_link()
in webhelpers.html.tags do not add prefixes or suffixes to the URL args
anymore; they output the exact URL given. Same for button_to() in
webhelpers.html.tools.
* webhelpers.html.tags.javascript_path was deleted.