documentation and comments in copy_properties