<commit_before>Backbone.LayoutManager
======================

**v0.8.0-pre** [![Build
Status](https://travis-ci.org/tbranyen/backbone.layoutmanager.png?branch=wip)](https://travis-ci.org/tbranyen/backbone.layoutmanager)

Created by <NAME> [@tbranyen](http://twitter.com/tbranyen), with help
from [awesome
contributors](https://github.com/tbranyen/backbone.layoutmanager/contributors)

Provides a logical foundation for assembling layouts and views within Backbone.
Designed to be adaptive and configurable for painless integration.  Well
tested, with full code coverage, in both the browser and Node.js environments.

Depends on Underscore, Backbone, and jQuery.  You can swap out the dependencies
with a custom configuration.

## Documentation ##

http://layoutmanager.org/

## Migrating from 0.7 ##

* Rename all instances of `Backbone.LayoutManager` and `Backbone.LayoutView` to
  `Backbone.Layout`.
* Rename all instances of `data` to `serialize`.
* Rename any instances of `_options` to `getAllOptions`.
* Rename any custom `append` functions to `insert`.
* Change all `render().view` references to `render()` the View is now returned
  instead of the deferred.  The same deferred properties are mixed in so you
  can keep `render().done` and `render().then` references.
* Upgrade your application to Backbone 0.9.9 and at least Underscore 1.4.2.
* Lo-Dash is no longer supported, use the lodash.underscore build instead.

## Release notes ##

* Massive Node.js refactor, including: unit testing, significantly better
  browser parity, and allowing more seamless browser/server View sharing.
* Ability to disable `Backbone.View#el` wrapper element using `el: false` and
  opt for the first child inside the template instead.
* Changed the return value for `render` to be the View.  This follows Backbone
  best practices.
* Added Backbone event bubbling from nested Views to parent.
* The `getView` function can receive a `_.where` object now, to easily filter
  through the Views.
* Updated `getView` to have an `undefined` first argument to be passed allowing
  for an optional selector.
* Changed Grunt configuration from JavaScript to CoffeeScript.
* Removed all aliases to `LayoutManager`.  Now only `Backbone.Layout` and
  `Backbone.View`.
* Added a `removeView` function to match `setView`, `getView`, etc.
* Removed `LayoutManager` and `LayoutView` aliases.
* Removed `data` alias in favor of `serialize`.
* Removed `append` alias in favor of `insert`.
* Renamed `_options` to `getAllOptions` making it an endorsed method to use.
* Upgraded minimum support to Backbone 0.9.9, which will invoke `stopListening`
  automatically for you.
* Internally implemented once to solve `afterRender` woes.
* Miscellaneous code cleanup and minor bug/refactor fixes.
* Class method `cache` now allows you to override contents.
* Class method `setupViews` now allows you to manage many Views by passing an
  array of Views.

[Full Release
Log](https://github.com/tbranyen/backbone.layoutmanager/blob/master/changelog.md)

## Contributing ##<commit_msg>moved migration guide to wiki<commit_after>Backbone.LayoutManager
======================

**v0.8.0-pre** [![Build
Status](https://travis-ci.org/tbranyen/backbone.layoutmanager.png?branch=wip)](https://travis-ci.org/tbranyen/backbone.layoutmanager)

Created by <NAME> [@tbranyen](http://twitter.com/tbranyen), with help
from [awesome
contributors](https://github.com/tbranyen/backbone.layoutmanager/contributors)

Provides a logical foundation for assembling layouts and views within Backbone.
Designed to be adaptive and configurable for painless integration.  Well
tested, with full code coverage, in both the browser and Node.js environments.

Depends on Underscore, Backbone, and jQuery.  You can swap out the dependencies
with a custom configuration.

## Documentation ##

http://layoutmanager.org/

## Migrating from 0.7 ##

http://layoutmanager.org/From-0.7-to-0.8

## Release notes ##

* Massive Node.js refactor, including: unit testing, significantly better
  browser parity, and allowing more seamless browser/server View sharing.
* Ability to disable `Backbone.View#el` wrapper element using `el: false` and
  opt for the first child inside the template instead.
* Added Backbone event bubbling from nested Views to parent.
* The `getView` function can receive a `_.where` object now, to easily filter
  through the Views.
* Updated `getView` to have an `undefined` first argument to be passed allowing
  for an optional selector.
* Changed Grunt configuration from JavaScript to CoffeeScript.
* Removed all aliases to `LayoutManager`.  Now only `Backbone.Layout` and
  `Backbone.View`.
* Added a `removeView` function to match `setView`, `getView`, etc.
* Removed `LayoutManager` and `LayoutView` aliases.
* Removed `data` alias in favor of `serialize`.
* Removed `append` alias in favor of `insert`.
* Renamed `_options` to `getAllOptions` making it an endorsed method to use.
* Upgraded minimum support to Backbone 0.9.9, which will invoke `stopListening`
  automatically for you.
* Internally implemented once to solve `afterRender` woes.
* Miscellaneous code cleanup and minor bug/refactor fixes.
* Class method `cache` now allows you to override contents.
* Class method `setupViews` now allows you to manage many Views by passing an
  array of Views.

[Full Release
Log](https://github.com/tbranyen/backbone.layoutmanager/blob/master/changelog.md)

## Contributing ##
{'fraction_non_alphanumeric': 0.10064397424103036, 'fraction_numerical': 0.004783808647654094, 'mean_word_length': 4.851453175457481, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 8, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6142004', 'n_tokens_mistral': 1580, 'n_tokens_neox': 1532, 'n_words': 615}