tbranyen/backbone.layoutmanager — pull request #184 by tbranyen (2012-10-19 15:52:48+00:00)
Title: 0.7.0 Release Candidate

Disclaimer
--------------

This has been tested in a few production applications, but for the most part has not been battle tested. Please drop into your application and follow the migration guide. Report all bugs in here.

**Merging on Monday**

Migration Guide From 0.6.*
------------------------------------

There have been a few small "breaking" changes that have been made to create a more unified and sane API. You should have to change relatively little to gain the benefits from this release. Please ask all questions in the comment area below and not open new issues.

* All `render` calls that previously took a function as a callback argument, should now be changed to `render().done` or `render().then` check out http://api.jquery.com/category/deferred-object/ for more information.
* Inside the `LayoutManager.configure` object, change the `paths` Object to `prefix` which is a single String property pointing to where your templates live.
* The above change may cause you to change your `template` properties for `Layouts`.
* If you were using `swapLayout` you can patch it back in, but it's removed due to lack of use case.

Every other change should be compatible with your existing implementation.

Changelog
---------------
* Removed `swapLayout`.
* `serialize` is deprecated and replaced by `data`.
* `render(callback)` is deprecated to `render().done()` deferreds only.
* Automatically unbind `model` and `collection` events inside `cleanup`.
* `Backbone.Layout`, `Backbone.LayoutView`, and `Backbone.LayoutManager` are now all identical.
* `options.paths` has been deprecated to a single String property `options.prefix`.
*