moved caveats into the description of the parameters they apply to.