Add some default handling for certificate authentication in the auth view controller

Certificate-based authentication is still not supported, however to better handle some
SSO (Single Sign-On) configurations the default handling is put in place.
Merge fix from AFNetworking that prevents intermittent failure of uploads

Sometimes the output stream in a bonded stream pair sends the has space available
event before the input stream is finished opening. Work around this by replaying
the speace available event after a delay.
Update BoxSDK.h docs to refer to Parallel OAuth2 and queue implementations

[BoxSDK sharedSDK] is configured with the parallel varieties and has been since the
inclusion of 09f1d69126f04c3718dd7a2bea15965faf6b7cfb
run chmod -x on some source files that were erroneously executable
Document that upload and download operations cannot be automatically retried

Upload and download SDK operations hold references to NSStreams for input and output.
NSStreams are not copyable so neither are these operations. The SDK relies on copying
operations to reenqueue them after an OAuth2 refresh event.

A common scenario when tokens need to be refreshed is when an app is first launched.
In this case, it is recommended to issue a heartbeat API call to a well known resource,
for example, the root folder, to ensure that tokens are refreshed before initiating an
upload or download.
Document that the SDK uses its own OAuth2 redirect URI

Since the SDK uses its own custom redirect URI to facilitate returning to your app,
this field must be left blank on the Box developer settings page for your service.
Add missing docs for retryWrite: in BoxAPIMultipartToJSON.m
Merge pull request #17 from box/docs/fixes

Documentation improvements
Add helper script to release docs
Fix typo in BoxFileBlock typedef

The argument to the block was erroneously named 'folder'.
Fix rotation issues with Folder Picker view controller children

BoxFolderPickerViewController is a container view controller.
One of the container VC's responsibilities is to properly size
the views contained within it.

This view controller contains a BoxFolderPickerTableViewController.
If the SDK does not have an OAuth2 session, the table view
controller is swapped it out for an authorization view
controller.

If the app is rotated while the authorization vc is active,
swapping back in the table vc when the user authenticates was
not correctly resizing the view which caused the table view
to render more narrowly than it should.

This commit follows Apple's recommendations for container view
controllers and sets the child's view bounds before making it
the active view.

@see http://developer.apple.com/library/ios/#featuredarticles/ViewControllerPGforiPhoneOS/CreatingCustomContainerViewControllers/CreatingCustomContainerViewControllers.html
Set the frame of the subview to the bounds of the superview, not the frame
Merge pull request #19 from box/folder-picker-fix-rotation-issues

Fix rotation issues with Folder Picker view controller children
Update setup instructions

Include additional frameworks that need to be linked to.
Add link to documentation site.
Add the ability to compare BoxModels to each other

This commit adds a compare:usingComparator: method to BoxModel as well
as several comparators that order models based on their properties.

Included comparators:

* type and id
* name
* size
* created and modified dates
* SHA1
Refactor BoxFoldersResourceManager to follow the style in BoxFilesResourceManager

When BoxFilesResourceManager was introduced, it bought with it some additional abstractions
for creating API operations and makes the process of creating a new endpoint more DRY.
Bring these changes to BoxFoldersResourceManager to make the SDK code more consistent.

This commit also factors out magic strings to constants for both internal and external
use.
Merge pull request #20 from box/feature/model-comparators

Add the ability to compare BoxModels to each other
Rename subresource constants and fix typo in method name in folders manager
Rename subresource constants and reformat files manager

Add linebreaks to long method invocations to make the code easier to
read.
Merge pull request #21 from box/refactor/folders-resource-manager

Refactor BoxFoldersResourceManager to follow the style in BoxFilesResourceManager