jquery.mobile.iscrollview
Release Notes

Version 1.2.6
=============
- Fixed `resizeWrapper()` so that calls from user code will always resize the wrapper, ignoring
the `resizeWrapper` setting. The purpose of the resizeWrapper setting is to prevent 
jquery.mobile.iscrollview from resizing the wrapper automatically, but it should always be permissible
for user code to resize the wrapper.

Version 1.2.5
=============
- Changed demo to use fixed/persistent header and footer.

- Insure that demo gets the current versions of .js and .css from /lib by using relative symlinks. 

- Use data-position="fixed" persistent header in demo. The use of persistent header/footer for
other than Navbars is poorly documented in JQM. It works great in 1.1.1, but 1.0.1 will always
transition the header with the page.

- Use data-position="fixed" footer in demo. This is needed for correct operation of persistent
toolbar. This works great in JQM 1.1.1, but there seems to be a slight problem still in 1.0.1,
where sometimes you will see the footer slide with the page.

- Fixed Issue #19, syntax error in calculateBarsHeight. This effected projects that use a
persistent toolbar.

- Get correct viewport height. The jQuery documentation incorrectly states that
viewport height = window height. This is not always the case, as the window height can be set
by code, and the viewport height can't. In fact, jQuery Mobile sets the window height to 99.99% of
the viewport height. Probably does not make a practical difference in most cases, but it is better
to do it correctly, in case a developer decides to go mucking with window height. The viewport is
technically the parent of window.

Version 1.2.4
=============
- Added minified versions of the library. (YUI and Closure)

Version 1.2.3
=============
- Failed to build demo after adding iScroll4 4.2 to 1.2.2. Re-built demo. No other changes.

Version 1.2.2
=============
- $.support.touch was removed from jQuery Mobile 1.7.2. Work around it.

- Updated iScroll4 in demo to version 4.2

Version 1.2.1
=============
- Bug fix for compatability with jQuery Mobile 1.2. The widget's _bind() function had a name 
conflict with the Widget Factory implementation in JQM 1.2. Renamed _bind -> _isvBind, 
_unbind -> _isvUnbind

Version 1.2
===========

Non Backward-Compatible
-----------------------
- You no longer need to create a <div> to contain multiple scrolled elements. In fact, you
  shouldn't (it will interfere with pull-down/pull-up). It will now scroll all content that is 
  inside of the wrapper. iScroll itself only scrolls the first child of the wrapper, but the widget 
  now creates a <div> around your content to contain it. 
  
- Events have been renamed. They are now all prefixed with "iscroll_on". See the documentation.

- Now comes with a jquery.mobile.iscrollview.css file. Please add this to your header.

New Features
------------
- Pull-down/Pull-up to refresh is implemented. Please see the documentation on how to use.

- Now deals correctly with padding on wrapper. It removes the padding and transfers it to the
  inner <div> that it creates to wrap your scrolled content. You shouldn't have to do anything
  special now to scroll either normal or inset listviews, for example. You will have to remove
  any padding/margins you added in the past to deal with padding issues.

- By default, calls made to refresh() and resizeWrapper() while a page is not the current page
  are deferred to the next pagebeforeshow event for that page. There are options to control this.
  
- No longer uses jquery.actual or patched iscroll.js.

- Option to prevent touch hover in scrollers when using jQuery Mobile 1.0 or 1.0.1.

- Demo has been much expanded. It now has 5 tabs demostrating different features, has buttons
  to load either jQuery Mobile 1.0.1 or 1.1, and illustrates changing header/footer size with
  orientation.
  
- Includes patched version of jQuery Mobile 1.1, with fix applied for slow links from long
  listviews.

Performance
-----------
- Significantly faster than 1.1 - 10X or more faster at widget creation and refresh.

- Extensive logging system for tracing and measuring critical methods, events, and callbacks.

Bug Fixes
---------
- Correct sizing on Safari Mobile related to address-bar.

- Persistant footer plays hide-and-seek, moving in and out of the page during transitions. Deal
  with this when sizing fixed-height elements.
  

