Update description to current state (sections: SPECIAL, KNOWN PROBLEMS).