Clarify the docs for compound objects a bit.
(#511)
Move the order of parameters for some classes back to the original order.  Don't want to change functionality by accident.
(#511)