Fix broken JavaDocs

You have been formatting your JavaDocs incorrectly, which means they aren't read properly by the JavaDoc tool. The main error comes from your use of ```@param```.

The correct usage of this annotation is:
```Java
@param theParameterName parameter description here
```
As opposed to:
```Java
@param parameter description
```

I would encourage you to have a good read though this http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html

Perhaps in particular these sections may be useful to you:
http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#styleguide
http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#tag