diff --git a/.gitignore b/.gitignore
index f0f555e..63961e9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -96,6 +96,7 @@
 /Makefile
 /Makefile.in
 /missing
+/INSTALL
 /stamp-h1
 /stamp-h2
 
@@ -106,3 +107,4 @@
 /include
 /libjson-c.a
 /libjson-c.so
+/libjson-c-*/
diff --git a/INSTALL b/INSTALL.md
similarity index 100%
rename from INSTALL
rename to INSTALL.md
diff --git a/json_object.h b/json_object.h
index 4bbc367..bfe6e46 100644
--- a/json_object.h
+++ b/json_object.h
@@ -329,20 +329,12 @@ JSON_EXPORT void json_object_set_serializer(json_object *jso,
 /**
  * Simply call free on the userdata pointer.
  * Can be used with json_object_set_serializer().
- *
- * @param jso unused
- * @param userdata the pointer that is passed to free().
  */
 json_object_delete_fn json_object_free_userdata;
 
 /**
  * Copy the jso->_userdata string over to pb as-is.
  * Can be used with json_object_set_serializer().
- *
- * @param jso The object whose _userdata is used.
- * @param pb The destination buffer.
- * @param level Ignored.
- * @param flags Ignored.
  */
 json_object_to_json_string_fn json_object_userdata_to_json_string;
 
@@ -434,7 +426,7 @@ JSON_EXPORT int json_object_object_add_ex(struct json_object* obj,
  * @deprecated Please use json_object_object_get_ex
  */
 JSON_EXPORT struct json_object* json_object_object_get(const struct json_object* obj,
-						  const char *key);
+						  const char *key) __deprecated;
 
 /** Get the json_object associated with a given object field.
  *
@@ -545,7 +537,7 @@ JSON_EXPORT size_t json_object_array_length(const struct json_object *obj);
 * Pointers to the json_object pointers will be passed as the two arguments
 * to @sort_fn
 *
-* @param obj the json_object instance
+* @param jso the json_object instance
 * @param sort_fn a sorting function
 */
 JSON_EXPORT void json_object_array_sort(struct json_object *jso, int(*sort_fn)(const void *, const void *));
diff --git a/linkhash.h b/linkhash.h
index 1493c80..e692a0b 100644
--- a/linkhash.h
+++ b/linkhash.h
@@ -308,7 +308,7 @@ extern int lh_table_length(struct lh_table *t);
  * 	However, because its interface is public, it will remain part of
  * 	the API on the off chance of legacy software using it externally.
  */
-void lh_abort(const char *msg, ...);
+void lh_abort(const char *msg, ...) __deprecated;
 
 /**
  * Resizes the specified table.