[doxygen] Fix Function.h typos

It's possible that the description isn't correct (about returning NaN). I didn't look into this.
Merge pull request #204 from opensim-org/function-doxygen-typo

[doxygen] Fix Function.h typos