Javadoc cleanup

src/main/java/microsoft/exchange/webservices/data/AccountIsLockedException.java

@@ -19,11 +19,9 @@ public class AccountIsLockedException extends ServiceRemoteException {
 
 	/**
 	 * Initializes a new instance of the AccountIsLockedException class.
-	 * @param message 
-	 * Error message text.
-	 * @param accountUnlockUrl
-	 * URL for client to visit to unlock account.
-	 * @param innerException
+	 *
+	 * @param message           Error message text.
+	 * @param accountUnlockUrl  URL for client to visit to unlock account.
 	 */
     public AccountIsLockedException(String message, URI accountUnlockUrl, 
     		Exception innerException) {

src/main/java/microsoft/exchange/webservices/data/AlternateId.java

@@ -26,6 +26,11 @@ public class AlternateId extends AlternateIdBase {
 	 */
 	private String mailbox;
 
+	/**
+	 * Type (primary or archive) mailbox to which the Id belongs
+	 */
+	private boolean isArchive;
+
 	/**
 	 * Initializes a new instance of the class.
 	 */
@@ -106,10 +111,7 @@ public void setMailbox(String mailbox) {
 
 	/**
 	 * Gets the type (primary or archive) mailbox to which the Id belongs.
-	 * 
-	 * @return the isArchive
 	 */
-	private boolean isArchive;
 	public boolean getIsArchive() {
 		return this.isArchive;
 	}

src/main/java/microsoft/exchange/webservices/data/AutodiscoverRequest.java

@@ -446,9 +446,7 @@ private SoapFaultDetails readSoapFault(EwsXmlReader reader) {
 	 * 
 	 * @param requestUrl
 	 *            Request URL.
-	 * @param memoryStream
-	 *            the memory stream
-	 * @return stream The stream.
+	 *
 	 * @throws javax.xml.stream.XMLStreamException
 	 *             the xML stream exception
 	 * @throws ServiceXmlSerializationException

src/main/java/microsoft/exchange/webservices/data/Conversation.java

@@ -383,8 +383,7 @@ public void setReadStateForItemsInConversation(
 	/**
 	 * Gets the Id of this Conversation.
 	 * @return Id
-	 * @throws ServiceLocalException 
-	 * @throws Exception 
+	 * @throws ServiceLocalException
 	 */
 	public ConversationId getId() throws ServiceLocalException {		
 		return (ConversationId)this.getPropertyBag().
@@ -830,4 +829,4 @@ public ItemIdCollection getGlobalItemIds() throws Exception {
 				ConversationSchema.GlobalItemIds); 
 	}
 
-}
+}

src/main/java/microsoft/exchange/webservices/data/ConversationAction.java

@@ -30,77 +30,76 @@ class ConversationAction {
 	private Date conversationLastSyncTime;
 
 	/**
-	 * Gets or sets conversation action
+	 * Gets conversation action
 	 * @return action
 	 */
 	protected ConversationActionType getAction() {
 		return this.action;
 	}
 
 	/**
-	 * Sets or sets conversation action
+	 * Sets conversation action
 	 */
 	protected void setAction(ConversationActionType value ) {
 		this.action = value;
 	}
 
 	/**
-	 * Gets or sets conversation id
+	 * Gets conversation id
 	 * @return conversationId
 	 */
 	protected ConversationId getConversationId() {
 		return this.conversationId;
 	}
 
 	/**
-	 * Sets or sets conversation id
+	 * Sets conversation id
 	 */
 	protected void setConversationId(ConversationId value) {
 		this.conversationId = value;
 	}
 
 	/**
-	 * Gets or sets ProcessRightAway
+	 * Gets ProcessRightAway
 	 * @return processRightAway
 	 */
 	protected boolean getProcessRightAway() {
 		return this.processRightAway;
 	}
 
 	/**
-	 * Sets or sets ProcessRightAway
-	 * @return processRightAway
+	 * Sets ProcessRightAway
 	 */
 	protected void setProcessRightAway(boolean value) {
 		this.processRightAway = value;
 	}
 
 
 	/**
-	 * Gets or set conversation categories for Always Categorize action
+	 * Gets conversation categories for Always Categorize action
 	 * @return categories
 	 */
 	protected StringList getCategories() {
 		return this.categories;
 	}
 
 	/**
-	 * Sets or set conversation categories for Always Categorize actions
+	 * Sets conversation categories for Always Categorize actions
 	 */
 	protected void setCategories(StringList value) {
 		this.categories = value;
 	}
 
 	/**
-	 * Gets or sets Enable Always Delete value for Always Delete action
+	 * Gets Enable Always Delete value for Always Delete action
 	 * @return enableAlwaysDelete
 	 */
 	protected boolean getEnableAlwaysDelete() {
 		return this.enableAlwaysDelete;
 	}
 
 	/**
-	 * Sets or sets Enable Always Delete value for Always Delete action
+	 * Sets Enable Always Delete value for Always Delete action
 	 */
 	protected void setEnableAlwaysDelete(boolean value) {
 		this.enableAlwaysDelete = value;
@@ -156,30 +155,30 @@ protected void setConversationLastSyncTime(Date value) {
 	}
 
 	/**
-	 * Gets or sets folder id ContextFolder
+	 * Gets folder id ContextFolder
 	 * @return contextFolderId
 	 */
 	protected FolderIdWrapper getContextFolderId() {
 		return this.contextFolderId;
 	}
 
 	/**
-	 * Sets or sets folder id ContextFolder
+	 * Sets folder id ContextFolder
 	 */
 	protected void setContextFolderId(FolderIdWrapper value) {
 		this.contextFolderId = value;
 	}
 
 	/**
-	 * Gets or sets folder id for Move action
+	 * Gets folder id for Move action
 	 * @return moveFolderId
 	 */
 	protected FolderIdWrapper getDestinationFolderId() {
 		return this.moveFolderId;
 	}
 
 	/**
-	 * Sets or sets folder id for Move action
+	 * Sets folder id for Move action
 	 */
 	protected void setDestinationFolderId(FolderIdWrapper value) {
 		this.moveFolderId = value;

src/main/java/microsoft/exchange/webservices/data/DeleteAttachmentRequest.java

@@ -117,7 +117,7 @@ protected String getResponseMessageXmlElementName() {
 	 * 
 	 * @param writer
 	 *            the writer
-	 * @return The writer.
+	 *
 	 * @throws Exception
 	 *             the exception
 	 */

src/main/java/microsoft/exchange/webservices/data/EwsServiceXmlWriter.java

@@ -351,9 +351,6 @@ public void writeNode(Node xmlNode) throws XMLStreamException {
 	}
 
 	/**
-	 * 
-	 * @param xmlNode
-	 * @param xmlStreamWriter
 	 * @throws javax.xml.stream.XMLStreamException
 	 */
 	public static void writeNode(Node xmlNode, XMLStreamWriter xmlStreamWriter)
@@ -379,9 +376,6 @@ public static void writeNode(Node xmlNode, XMLStreamWriter xmlStreamWriter)
 	}
 
 	/**
-	 * 
-	 * @param document
-	 * @param xmlStreamWriter
 	 * @throws javax.xml.stream.XMLStreamException
 	 */
 	public static void writeToDocument(Document document,
@@ -394,9 +388,6 @@ public static void writeToDocument(Document document,
 	}
 
 	/**
-	 * 
-	 * @param element
-	 * @param writer
 	 * @throws javax.xml.stream.XMLStreamException
 	 */
 	public static void addElement(Element element, XMLStreamWriter writer)
@@ -569,10 +560,7 @@ public boolean isRequireWSSecurityUtilityNamespace() {
 	}
 
 	/**
-	 *   Sets a value indicating whether the SOAP message need WSSecurity Utility namespace.
-	 * 
-	 * @param requireWSSecurityUtilityNamespace
-	 *            
+	 * Sets a value indicating whether the SOAP message need WSSecurity Utility namespace.
 	 */
 	public void setRequireWSSecurityUtilityNamespace(boolean requireWSSecurityUtilityNamespace) {
 		this.requireWSSecurityUtilityNamespace = requireWSSecurityUtilityNamespace;

src/main/java/microsoft/exchange/webservices/data/ExchangeService.java

@@ -2271,9 +2271,7 @@ public PushSubscription subscribeToPushNotifications(
 	 * @param eventTypes
 	 *            The event types to subscribe to.
 	 * @return An IAsyncResult that references the asynchronous request.
-	 * @throws Exception 
 	 * @throws Exception
-	 *             the exception
 	 */
 	public IAsyncResult beginSubscribeToPushNotifications(
 			AsyncCallback callback, Object state, Iterable<FolderId> folderIds,
@@ -2527,15 +2525,14 @@ public IAsyncResult beginSubscribeToStreamingNotifications(AsyncCallback callbac
 	}*/
 
 	/**
-	 *Begins an asynchronous request to subscribe to streaming notifications on
+	 * Begins an asynchronous request to subscribe to streaming notifications on
 	 * all folders in the authenticated user's mailbox. Calling this method
 	 * results in a call to EWS.
 	 * 
-	 *@param callback
+	 * @param callback
 	 *            The AsyncCallback delegate
-	 *@param state
+	 * @param state
 	 *            An object that contains state information for this request.
-	 *@param eventTypes
 	 * @throws Exception 
 	 * @return An IAsyncResult that references the asynchronous request.
 	 **/

src/main/java/microsoft/exchange/webservices/data/ExchangeServiceBase.java

@@ -122,11 +122,6 @@ protected HttpConnectionManager getSimpleHttpConnectionManager() {
 	private static String defaultUserAgent = "ExchangeServicesClient/" + 
 	EwsUtilities.getBuildVersion();
 
-	/**
-	 * 
-	 * @param service
-	 * @param requestedServerVersion
-	 */
 	protected ExchangeServiceBase(ExchangeServiceBase service,
 			ExchangeVersion requestedServerVersion) {
 		this(requestedServerVersion);
@@ -301,10 +296,7 @@ protected HttpWebRequest prepareHttpWebRequestForUrl(URI url,
 	 * This method doesn't handle 500 ISE errors. This is handled by the caller since
      * 500 ISE typically indicates that a SOAP fault has occurred and the handling of
      * a SOAP fault is currently service specific.
-	 * @param httpWebResponse
-	 * @param webException
-	 * @param responseHeadersTraceFlag
-	 * @param responseTraceFlag
+	 *
 	 * @throws Exception
 	 */
 	protected void internalProcessHttpErrorResponse(
@@ -347,8 +339,6 @@ protected void internalProcessHttpErrorResponse(
 	}
 
 	/**
-	 * 
-	 * @param location
 	 * @return false if location is null,true if this abstract pathname is
 	 *         absolute,
 	 */
@@ -361,9 +351,6 @@ public static boolean checkURIPath(String location) {
 	  }
 
 	/**
-	 * 
-	 * @param httpWebResponse
-	 * @param webException
 	 * @throws Exception
 	 */
 	protected abstract void processHttpErrorResponse(
@@ -1037,7 +1024,6 @@ protected void processHttpResponseHeaders(TraceFlags traceType, HttpWebRequest r
 
    /**
     * Save the HTTP response headers.
-    * @summary
     * @param headers The response headers
     */
 	private void saveHttpResponseHeaders(Map<String, String> headers) {

src/main/java/microsoft/exchange/webservices/data/ExecuteDiagnosticMethodResponse.java

@@ -62,8 +62,6 @@ protected void readElementsFromXml(EwsServiceXmlReader reader)
 
 
 	/**
-	 * 
-	 * @param xmlEventReader
 	 * @return document
 	 * @throws javax.xml.parsers.ParserConfigurationException
 	 */

src/main/java/microsoft/exchange/webservices/data/FileAttachment.java

@@ -58,7 +58,6 @@ protected String getXmlElementName() {
 	 *            the attachment index
 	 * @throws ServiceValidationException
 	 *             the service validation exception
-	 * @Index of this attachment
 	 */
 	void validate(int attachmentIndex) throws ServiceValidationException {
 		try {

src/main/java/microsoft/exchange/webservices/data/FindConversationRequest.java

@@ -16,8 +16,7 @@ final class FindConversationRequest extends SimpleServiceRequestBase {
 	private SearchFilter.IsEqualTo searchFilter;
 	private FolderIdWrapper folderId;
 
-	/**	  
-	 * @param service
+	/**
 	 * @throws Exception 
 	 */
 	protected FindConversationRequest(ExchangeService service) 

src/main/java/microsoft/exchange/webservices/data/FolderWrapper.java

@@ -46,7 +46,7 @@ public Folder getFolder() {
 	 * 
 	 * @param writer
 	 *            the writer
-	 * @return The Folder object associated with the wrapper
+	 *
 	 * @throws Exception
 	 *             the exception
 	 */

src/main/java/microsoft/exchange/webservices/data/GenericPropertyDefinition.java

@@ -12,9 +12,7 @@
 /**
  * Represents generic property definition.
  * 
- * @param <T>
- *            the generic type
- * @Param T Property type.
+ * @param <TPropertyValue> Property type.
  */
 class GenericPropertyDefinition<TPropertyValue> extends 
 TypedPropertyDefinition {
@@ -81,17 +79,13 @@ protected GenericPropertyDefinition(
 	/**
 	 * Parses the specified value.
 	 * 
-	 * @param value
-	 *            the value
-	 * @return the object
-	 * @throws java.text.ParseException
-	 * @throws IllegalAccessException 
-	 * @throws InstantiationException 
+	 * @param value The value
+	 *
+	 * @return Double value from parsed value.
+	 *
 	 * @throws java.text.ParseException
 	 * @throws IllegalAccessException 
-	 * @throws InstantiationException 
-	 * @Param value The value
-	 * @return Double value from parsed value.
+	 * @throws InstantiationException
 	 */	
 	@Override
 	protected Object parse(String value) throws InstantiationException, 
@@ -107,4 +101,4 @@ protected Object parse(String value) throws InstantiationException,
 	public Class<TPropertyValue> getType() {	
 		return instance;
 	}
-}
+}