Deprecated some functions and improved method documentation

Deprecated some functions and improved method documentation
I removed @ because it was only introduced for PHP 4