Add "param" and "returns" comments to all public functions

[Kytzis]

After adding DocFX online documentation, it would be nice if every function it displays has properly defined parameter and return values