DOC: added documentation of attribute assignment.