added a large amount of missing documentation
better use @see for See in phpdoc