Information should be added to the reference manual to the section, " Modifying detached objects", currently 11.6, and/or the Development Guide.