more documentation about special values, and some fixes