Updating docs for recent API changes, warnings.