Javadoc fixes (#122).

Author: gmessner

src/main/java/org/gitlab4j/api/CommitsApi.java

@@ -299,7 +299,7 @@ public Comment addComment(int projectId, String sha, String note) throws GitLabA
      * @param authorName the commit author's name
      * @param actions the array of CommitAction to commit as a batch
      * @return the create Commit instance
-     * @throws GitLabApiException
+     * @throws GitLabApiException if any exception occurs during execution
      */
     public Commit createCommit(int projectId, String branch, String commitMessage, String startBranch,
             String authorEmail, String authorName, List<CommitAction> actions) throws GitLabApiException {
@@ -329,7 +329,7 @@ public Commit createCommit(int projectId, String branch, String commitMessage, S
      * @param authorName the commit author's name
      * @param actions the array of CommitAction to commit as a batch
      * @return the create Commit instance
-     * @throws GitLabApiException
+     * @throws GitLabApiException if any exception occurs during execution
      */
     public Commit createCommit(String project, String branch, String commitMessage, String startBranch,
             String authorEmail, String authorName, List<CommitAction> actions) throws GitLabApiException {

src/main/java/org/gitlab4j/api/GitLabApiClient.java

@@ -418,8 +418,9 @@ protected Response post(MultivaluedMap<String, String> queryParams, URL url) {
      * a ClientResponse instance with the data returned from the endpoint.
      *
      * @param payload the object instance that will be serialized to JSON and used as the POST data
-     * @param url the fully formed path to the GitLab API endpoint
+     * @param pathArgs variable list of arguments used to build the URI
      * @return a ClientResponse instance with the data returned from the endpoint
+     * @throws IOException if an error occurs while constructing the URL
      */
     protected Response post(Object payload, Object... pathArgs) throws IOException {
         URL url = getApiUrl(pathArgs);