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.
auto merge of #9585 : vky/rust/num-docs, r=alexcrichton

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