Comments refactor and some addition methods

I've refactored comments to more standard ```/***/``` syntax with phpdoc for IDEs.

Plus there are a couple of additional functions. More will follow