diff --git a/core/java/src/org/json/simple/ItemList.java b/core/java/src/org/json/simple/ItemList.java
index 07231e673379c9d69f0e76700a0e8ba180151cca..3d1213a11f12d3d89cc001e5df86eafa01ee38e7 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 104f44698b706cfb2ae5bf83af9760e2d4263ed0..e1dbf266cef3de18bb9d510e19d9de3726b1a8c3 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 aba3c40c2032541663ccd0b476aab62dc85d50cc..fc9fab254d3ed75c6b4d52b288ea739aaa202340 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 0000000000000000000000000000000000000000..0c028c5722fc2a66bc034ef0c90247ec9279feee
--- /dev/null
+++ b/core/java/src/org/json/simple/package.html
@@ -0,0 +1,11 @@
+<html>
+<body>
+<p>
+This is json-simple release 1.1.1 2012-02-19
+retrieved from <a href="https://github.com/cliftonlabs/json-simple">github</a>.
+</p><p>
+Unmodified, except for javadoc fixes.
+Apache 2.
+</p>
+</body>
+</html>