Added comments to public functions in num.rs.

Copied existing comments from other files, and added comments to
functions that did not have existing comments available.