Phpdoc comments fixed

My IDE (PHPStorm) was complaining about PHPDoc some comments mishaps so I went through all of them and fixed them appropriately.