update documentation for semiconitnuous, semi-int, and variable()

There were some objections to documenting variable(), but for the time being let's just fix the out of date docs so that we can release 0.6.2.