fixed docu warnings

Author: a-brandt

src/main/java/com/arangodb/ArangoDriver.java

@@ -947,8 +947,6 @@ public <T> DocumentEntity<T> createDocument(final String collectionName, final T
 	 *            the desired document key
 	 * @param value
 	 *            An object containing the documents attributes
-	 * @param createCollection
-	 *            if set to true the collection is created if it does not exist
 	 * @param waitForSync
 	 *            if set to true the response is returned when the server has
 	 *            finished.
@@ -975,8 +973,6 @@ public DocumentEntity<?> createDocument(
 	 *            the desired document key
 	 * @param value
 	 *            An object containing the documents attributes
-	 * @param createCollection
-	 *            if set to true the collection is created if it does not exist
 	 * @param waitForSync
 	 *            if set to true the response is returned when the server has
 	 *            finished.
@@ -2936,7 +2932,7 @@ public UserEntity getUser(final String username) throws ArangoException {
 	 * @param username
 	 *            the username as string
 	 * @param database
-	 * @return
+	 * @return a DefaultEntity object
 	 * @throws ArangoException
 	 */
 	public DefaultEntity grantDatabaseAccess(String username, String database) throws ArangoException {
@@ -4688,7 +4684,7 @@ public QueriesResultEntity getSlowQueries(final String database) throws ArangoEx
 	/**
 	 * Clears the list of slow AQL queries of the default database
 	 * 
-	 * @return
+	 * @return a DefaultEntity object
 	 * @throws ArangoException
 	 */
 	public DefaultEntity deleteSlowQueries() throws ArangoException {
@@ -4700,7 +4696,7 @@ public DefaultEntity deleteSlowQueries() throws ArangoException {
 	 * 
 	 * @param database
 	 *            the database name or null
-	 * @return
+	 * @return a DefaultEntity object
 	 * @throws ArangoException
 	 */
 	public DefaultEntity deleteSlowQueries(final String database) throws ArangoException {
@@ -4712,7 +4708,7 @@ public DefaultEntity deleteSlowQueries(final String database) throws ArangoExcep
 	 * 
 	 * @param id
 	 *            the identifier of a query
-	 * @return
+	 * @return a DefaultEntity object
 	 * @throws ArangoException
 	 */
 	public DefaultEntity killQuery(final String id) throws ArangoException {
@@ -4726,7 +4722,7 @@ public DefaultEntity killQuery(final String id) throws ArangoException {
 	 *            the identifier of a query
 	 * @param database
 	 *            the database name or null
-	 * @return
+	 * @return a DefaultEntity object
 	 * @throws ArangoException
 	 */
 	public DefaultEntity killQuery(final String database, final String id) throws ArangoException {
@@ -4749,8 +4745,6 @@ public HttpManager getHttpManager() {
 	 *            The name of the collection
 	 * @param rawJsonString
 	 *            A string containing a JSON object
-	 * @param createCollection
-	 *            if set to true the collection is created if it does not exist
 	 * @param waitForSync
 	 *            if set to true the response is returned when the server has
 	 *            finished.

src/main/java/com/arangodb/entity/QueryEntity.java

@@ -46,7 +46,7 @@ public void setId(String id) {
 	/**
 	 * Returns the query string (potentially truncated)
 	 * 
-	 * @return
+	 * @return the query string
 	 */
 	public String getQuery() {
 		return query;

src/main/java/com/arangodb/util/GraphEdgesOptions.java

@@ -205,7 +205,8 @@ public GraphEdgesOptions setLimit(Integer limit) {
 	/**
 	 * Get include data
 	 * 
-	 * @return
+	 * @return returns true, if the return values are compatible with older
+	 *         versions of AnrangoDB
 	 */
 	public Boolean getIncludeData() {
 		return includeData;

src/main/java/com/arangodb/util/ShortestPathOptions.java

@@ -151,7 +151,8 @@ public ShortestPathOptions setDefaultWeight(Long defaultWeight) {
 	/**
 	 * Get include data
 	 * 
-	 * @return
+	 * @return returns true, if the return values are compatible with older
+	 *         versions of AnrangoDB
 	 */
 	public Boolean getIncludeData() {
 		return includeData;