ticket:7912: final update to apidocs. Also removed references to non-existent kDecimalNumber (from fmtable.h), and cleaned up other docs


git-svn-id: http://source.icu-project.org/repos/icu/icu@33905 251d0590-4201-4cf1-90de-194747b24ca1