Rewriting  some javadocs

So it better fits the purpuse of the cooresponding method