change insert documentation to match behavior

The insert macro does not return the last inserted id, but rather a
database-dependent representation of the last inserted row.

closes #208