adds appropriate documentation to these previously undocumented constructors.