Parsed documentation:
View on GitHub
@return [Container]
  places all objects in a new, parent-less container, saves it off,
  None of the objects are permitted to be new_records.
  !! If an object is in another container it is moved to the new container created here.
Please help! Open an issue on GitHub if this assessment is incorrect.