Add missing parameters on handwritten core files

Author: Caitlin Bales (MSFT)

src/main/java/com/microsoft/graph/http/CustomRequest.java

@@ -65,7 +65,6 @@ public void delete() throws ClientException {{
 
     /**
      * Patches this item with a source
-     * @param sourceItem The source object with updates
      * @param callback The callback to be called after success or failure.
      */
     public void patch(final ICallback<T> callback) {
@@ -74,7 +73,7 @@ public void patch(final ICallback<T> callback) {
 
     /**
      * Patches this item with a source
-     * @param sourceAttachment The source object with updates
+     * @param sourceObject The source object with updates
      * @return The updated item
      * @throws ClientException This exception occurs if the request was unable to complete for any reason.
      */
@@ -84,7 +83,7 @@ public T patch(final T sourceObject) throws ClientException {
 
     /**
      * Creates a new object
-     * @param newAttachment The new object to create
+     * @param newObject The new object to create
      * @param callback The callback to be called after success or failure.
      */
     public void post(final T newObject, final ICallback<T> callback) {
@@ -93,8 +92,8 @@ public void post(final T newObject, final ICallback<T> callback) {
 
     /**
      * Creates a new object
-     * @param newAttachment The new object to create
-     * @return The created Attachment
+     * @param newObject The new object to create
+     * @return The created object
      * @throws ClientException This exception occurs if the request was unable to complete for any reason.
      */
     public T post(final T newObject) throws ClientException {

src/main/java/com/microsoft/graph/http/GraphFatalServiceException.java

@@ -41,6 +41,7 @@ public class GraphFatalServiceException extends GraphServiceException {
      * @param responseMessage The response message.
      * @param responseHeaders The response headers.
      * @param error The error response if available.
+     * @param verbose Whether or not to log verbosely.
      */
     protected GraphFatalServiceException(final String method,
                                          final String url,

src/main/java/com/microsoft/graph/http/GraphServiceException.java

@@ -237,6 +237,7 @@ public GraphError getServiceError() {
      * @param serializable The serialized object that was sent with this request.
      * @param serializer   The serializer to re-create the option in its over the wire state.
      * @param connection   The connection that was used to extract the response information from.
+     * @param logger       The logger to log exception information to.
      * @param <T>          The type of the serializable object.
      * @return The new GraphServiceException instance.
      * @throws IOException An exception occurs if there were any problems processing the connection.

src/main/java/com/microsoft/graph/requests/extensions/GraphServiceClient.java

@@ -45,8 +45,8 @@ public CustomRequestBuilder customRequest(final String url, final Class response
     }
 
     /**
-     * end a custom request to Graph
-     * @param url THe full URL to make a request with
+     * Send a custom request to Graph
+     * @param url The full URL to make a request with
      * @return the instance of this builder
      */
     public CustomRequestBuilder customRequest(final String url) {
@@ -137,6 +137,7 @@ public Builder fromConfig(final IClientConfig clientConfig) {
         /**
          * Builds and returns the GraphServiceClient
          * @throws ClientException if there was an exception creating the client
+         * @return The GraphServiceClient object
          */
         public IGraphServiceClient buildClient() throws ClientException  {
             client.validate();

src/main/java/com/microsoft/graph/serializer/FallBackEnumTypeAdapter.java

@@ -58,7 +58,7 @@ public class FallBackEnumTypeAdapter implements TypeAdapterFactory {
      *
      * @param gson GSON
      * @param type The type.
-     * @return <T> The type adapter
+     * @return The type adapter
      */
     public <T> TypeAdapter<T> create(final Gson gson, final TypeToken<T> type) {
         //no inspection unchecked

src/main/java/com/microsoft/graph/serializer/IJsonBackedObject.java

@@ -40,6 +40,7 @@ public interface IJsonBackedObject {
     /**
      * Provides access to objects not anticipated in the model, as well as 
      * request and response data from the HTTP call
+     * @return The AddtionalDataManager
      */
     AdditionalDataManager additionalDataManager();
 

src/main/java/com/microsoft/graph/serializer/ISerializer.java

@@ -41,9 +41,10 @@ public interface ISerializer {
 
     /**
      * Deserialize an object from the input string.
-     * @param inputString The string that stores the representation of the item.
-     * @param clazz The .class of the item to be deserialized.
-     * @param <T> The type of the item to be deserialized.
+     * @param inputString     The string that stores the representation of the item.
+     * @param clazz           The .class of the item to be deserialized.
+     * @param responseHeaders The HTTP response headers.
+     * @param <T>             The type of the item to be deserialized.
      * @return The deserialized item from the input string.
      */
     <T> T deserializeObject(final String inputString, Class<T> clazz, Map<String, List<String>> responseHeaders);