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. 

cc #7511