document the return value of the 'create' method and fix synopsis rendering of 'destroy' method