#insert optim with respond_to? plus documentation tweak

RUBY-676