Javadoc needs a sweep

[badgerwithagun]

Prior to 1.0.0, the Javadoc needs a thorough sweep for detail, accuracy and consistency.

[badgerwithagun]

Improved a little by #33 but that was purely about fixing errors. Still needs improving.

[venushka]

Also the following warning should be fixed as well.

[WARNING] /home/travis/build/alfasoftware/morf/morf-nuodb/src/main/java/org/alfasoftware/morf/jdbc/nuodb/NuoDBHelper.java:22: warning: no @param for stringOfDouble
[WARNING] public static Double nuoDBConvertStringToDouble(String stringOfDouble) {
[WARNING] ^
[WARNING] /home/travis/build/alfasoftware/morf/morf-nuodb/src/main/java/org/alfasoftware/morf/jdbc/nuodb/NuoDBHelper.java:22: warning: no @return
[WARNING] public static Double nuoDBConvertStringToDouble(String stringOfDouble) {
[WARNING] ^
[WARNING] /home/travis/build/alfasoftware/morf/morf-nuodb/src/main/java/org/alfasoftware/morf/jdbc/nuodb/NuoDBHelper.java:33: warning: no @param for referenceToCast
[WARNING] public static Cast nuoDBCastToString(AliasedField referenceToCast, int length) {
[WARNING] ^
[WARNING] /home/travis/build/alfasoftware/morf/morf-nuodb/src/main/java/org/alfasoftware/morf/jdbc/nuodb/NuoDBHelper.java:33: warning: no @param for length
[WARNING] public static Cast nuoDBCastToString(AliasedField referenceToCast, int length) {
[WARNING] ^
[WARNING] /home/travis/build/alfasoftware/morf/morf-nuodb/src/main/java/org/alfasoftware/morf/jdbc/nuodb/NuoDBHelper.java:33: warning: no @return
[WARNING] public static Cast nuoDBCastToString(AliasedField referenceToCast, int length) {
[WARNING] ^
[WARNING] /home/travis/build/alfasoftware/morf/morf-nuodb/src/main/java/org/alfasoftware/morf/jdbc/nuodb/NuoDBHelper.java:43: warning: no @param for bigDecimal
[WARNING] public static String nuoDBConvertBigDecimalToPlainString(BigDecimal bigDecimal) {
[WARNING] ^
[WARNING] /home/travis/build/alfasoftware/morf/morf-nuodb/src/main/java/org/alfasoftware/morf/jdbc/nuodb/NuoDBHelper.java:43: warning: no @return
[WARNING] public static String nuoDBConvertBigDecimalToPlainString(BigDecimal bigDecimal) {
[WARNING] ^