DOC: document the changes to the shapes parameter.