diff --git a/core/java/src/org/json/simple/ItemList.java b/core/java/src/org/json/simple/ItemList.java
index 07231e6733..3d1213a11f 100644
--- a/core/java/src/org/json/simple/ItemList.java
+++ b/core/java/src/org/json/simple/ItemList.java
@@ -107,7 +107,7 @@ public class ItemList {
/**
* @param i 0-based
- * @return
+ * @return the value
*/
public String get(int i){
return (String)items.get(i);
diff --git a/core/java/src/org/json/simple/JSONObject.java b/core/java/src/org/json/simple/JSONObject.java
index 104f44698b..e1dbf266ce 100644
--- a/core/java/src/org/json/simple/JSONObject.java
+++ b/core/java/src/org/json/simple/JSONObject.java
@@ -138,7 +138,7 @@ public class JSONObject extends HashMap implements Map, JSONAware, JSONStreamAwa
* @see org.json.simple.JSONValue#escape(String)
*
* @param s
- * @return
+ * @return the value
*/
public static String escape(String s){
return JSONValue.escape(s);
diff --git a/core/java/src/org/json/simple/JSONValue.java b/core/java/src/org/json/simple/JSONValue.java
index aba3c40c20..fc9fab254d 100644
--- a/core/java/src/org/json/simple/JSONValue.java
+++ b/core/java/src/org/json/simple/JSONValue.java
@@ -90,7 +90,7 @@ public class JSONValue {
* @see org.json.simple.JSONArray#writeJSONString(List, Writer)
*
* @param value
- * @param writer
+ * @param out
*/
public static void writeJSONString(Object value, Writer out) throws IOException {
if(value == null){
@@ -210,7 +210,7 @@ public class JSONValue {
/**
* Escape quotes, \, /, \r, \n, \b, \f, \t and other control characters (U+0000 through U+001F).
* @param s
- * @return
+ * @return the value
*/
public static String escape(String s){
if(s==null)
diff --git a/core/java/src/org/json/simple/package.html b/core/java/src/org/json/simple/package.html
new file mode 100644
index 0000000000..0c028c5722
--- /dev/null
+++ b/core/java/src/org/json/simple/package.html
@@ -0,0 +1,11 @@
+
+
+
+This is json-simple release 1.1.1 2012-02-19
+retrieved from github.
+
+Unmodified, except for javadoc fixes.
+Apache 2.
+
+
+