Fix some javadoc errors.
diff --git a/activation/src/main/java/javax/activation/CommandInfo.java b/activation/src/main/java/javax/activation/CommandInfo.java index 41fff46..439ef12 100644 --- a/activation/src/main/java/javax/activation/CommandInfo.java +++ b/activation/src/main/java/javax/activation/CommandInfo.java
@@ -130,6 +130,9 @@ * passed to the command. * @param loader The ClassLoader to be used to instantiate the bean. * @return The bean + * @exception IOException for failures reading data + * @exception ClassNotFoundException if command object class can't + * be found * @see java.beans.Beans#instantiate * @see javax.activation.CommandObject */
diff --git a/activation/src/main/java/javax/activation/CommandMap.java b/activation/src/main/java/javax/activation/CommandMap.java index eca27cc..2f83c89 100644 --- a/activation/src/main/java/javax/activation/CommandMap.java +++ b/activation/src/main/java/javax/activation/CommandMap.java
@@ -1,7 +1,7 @@ /* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * - * Copyright (c) 1997-2015 Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997-2017 Oracle and/or its affiliates. All rights reserved. * * The contents of this file are subject to the terms of either the GNU * General Public License Version 2 only ("GPL") or the Common Development @@ -60,7 +60,6 @@ /** * Get the default CommandMap. - * <p> * * <ul> * <li> In cases where a CommandMap instance has been previously set
diff --git a/activation/src/main/java/javax/activation/CommandObject.java b/activation/src/main/java/javax/activation/CommandObject.java index 810cfd0..c9331f7 100644 --- a/activation/src/main/java/javax/activation/CommandObject.java +++ b/activation/src/main/java/javax/activation/CommandObject.java
@@ -1,7 +1,7 @@ /* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * - * Copyright (c) 1997-2015 Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997-2017 Oracle and/or its affiliates. All rights reserved. * * The contents of this file are subject to the terms of either the GNU * General Public License Version 2 only ("GPL") or the Common Development @@ -49,7 +49,7 @@ * data they should operate on. JavaBeans that don't implement * this interface may be used as well. Such commands may obtain * the data using the Externalizable interface, or using an - * application-specific method.<p> + * application-specific method. */ public interface CommandObject { @@ -61,6 +61,7 @@ * * @param verb The Command Verb this object refers to. * @param dh The DataHandler. + * @exception IOException for failures accessing data */ public void setCommandContext(String verb, DataHandler dh) throws IOException;
diff --git a/activation/src/main/java/javax/activation/DataHandler.java b/activation/src/main/java/javax/activation/DataHandler.java index 72b3532..7a2e86b 100644 --- a/activation/src/main/java/javax/activation/DataHandler.java +++ b/activation/src/main/java/javax/activation/DataHandler.java
@@ -1,7 +1,7 @@ /* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * - * Copyright (c) 1997-2015 Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997-2017 Oracle and/or its affiliates. All rights reserved. * * The contents of this file are subject to the terms of either the GNU * General Public License Version 2 only ("GPL") or the Common Development @@ -339,6 +339,7 @@ * Otherwise, <code>null</code> is returned. * * @return the OutputStream + * @exception IOException for failures creating the OutputStream * * @see javax.activation.DataSource#getOutputStream * @see javax.activation.URLDataSource
diff --git a/activation/src/main/java/javax/activation/DataSource.java b/activation/src/main/java/javax/activation/DataSource.java index 4e63cd3..6e5f139 100644 --- a/activation/src/main/java/javax/activation/DataSource.java +++ b/activation/src/main/java/javax/activation/DataSource.java
@@ -1,7 +1,7 @@ /* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * - * Copyright (c) 1997-2015 Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997-2017 Oracle and/or its affiliates. All rights reserved. * * The contents of this file are subject to the terms of either the GNU * General Public License Version 2 only ("GPL") or the Common Development @@ -62,6 +62,7 @@ * positioned at the beginning of the data. * * @return an InputStream + * @exception IOException for failures creating the InputStream */ public InputStream getInputStream() throws IOException; @@ -73,6 +74,7 @@ * be positioned at the location the data is to be written. * * @return an OutputStream + * @exception IOException for failures creating the OutputStream */ public OutputStream getOutputStream() throws IOException;
diff --git a/activation/src/main/java/javax/activation/MailcapCommandMap.java b/activation/src/main/java/javax/activation/MailcapCommandMap.java index 5d3ce50..7489f0a 100644 --- a/activation/src/main/java/javax/activation/MailcapCommandMap.java +++ b/activation/src/main/java/javax/activation/MailcapCommandMap.java
@@ -59,7 +59,6 @@ * system for mailcap file entries. When requests are made * to search for commands in the MailcapCommandMap, it searches * mailcap files in the following order: - * <p> * <ol> * <li> Programatically added entries to the MailcapCommandMap instance. * <li> The file <code>.mailcap</code> in the user's home directory. @@ -92,7 +91,7 @@ * specifically those parameter names that begin with <code>x-java-</code>. * The MailcapCommandMap uses this signature to find * command entries for inclusion into its registries. - * Parameter names with the form <code>x-java-<name></code> + * Parameter names with the form <code>x-java-<name></code> * are read by the MailcapCommandMap as identifying a command * with the name <i>name</i>. When the <i>name</i> is <code> * content-handler</code> the MailcapCommandMap recognizes the class @@ -117,7 +116,7 @@ * following general form:<p> * <code> * # Comments begin with a '#' and continue to the end of the line.<br> - * <mime type>; ; <parameter list><br> + * <mime type>; ; <parameter list><br> * # Where a parameter list consists of one or more parameters,<br> * # where parameters look like: x-java-view=com.sun.TextViewer<br> * # and a parameter list looks like: <br> @@ -671,6 +670,7 @@ * entries that specify a view command for the specified * MIME type are returned. * + * @param mimeType the MIME type * @return array of native command entries * @since JAF 1.1 */
diff --git a/activation/src/main/java/javax/activation/MimeType.java b/activation/src/main/java/javax/activation/MimeType.java index f602864..140821a 100644 --- a/activation/src/main/java/javax/activation/MimeType.java +++ b/activation/src/main/java/javax/activation/MimeType.java
@@ -1,7 +1,7 @@ /* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * - * Copyright (c) 1997-2015 Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997-2017 Oracle and/or its affiliates. All rights reserved. * * The contents of this file are subject to the terms of either the GNU * General Public License Version 2 only ("GPL") or the Common Development @@ -71,6 +71,7 @@ * Constructor that builds a MimeType from a String. * * @param rawdata the MIME type string + * @exception MimeTypeParseException if the MIME type can't be parsed */ public MimeType(String rawdata) throws MimeTypeParseException { parse(rawdata); @@ -271,6 +272,7 @@ * * @param rawdata the MIME type string to compare with * @return true if they match + * @exception MimeTypeParseException if the MIME type can't be parsed */ public boolean match(String rawdata) throws MimeTypeParseException { return match(new MimeType(rawdata));
diff --git a/activation/src/main/java/javax/activation/MimeTypeParameterList.java b/activation/src/main/java/javax/activation/MimeTypeParameterList.java index c855959..5b5fccf 100644 --- a/activation/src/main/java/javax/activation/MimeTypeParameterList.java +++ b/activation/src/main/java/javax/activation/MimeTypeParameterList.java
@@ -1,7 +1,7 @@ /* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * - * Copyright (c) 1997-2015 Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997-2017 Oracle and/or its affiliates. All rights reserved. * * The contents of this file are subject to the terms of either the GNU * General Public License Version 2 only ("GPL") or the Common Development @@ -71,6 +71,7 @@ * Constructs a new MimeTypeParameterList with the passed in data. * * @param parameterList an RFC 2045, 2046 compliant parameter list. + * @exception MimeTypeParseException if the MIME type can't be parsed */ public MimeTypeParameterList(String parameterList) throws MimeTypeParseException { @@ -84,6 +85,7 @@ * A routine for parsing the parameter list out of a String. * * @param parameterList an RFC 2045, 2046 compliant parameter list. + * @exception MimeTypeParseException if the MIME type can't be parsed */ protected void parse(String parameterList) throws MimeTypeParseException { if (parameterList == null)
diff --git a/activation/src/main/java/javax/activation/MimetypesFileTypeMap.java b/activation/src/main/java/javax/activation/MimetypesFileTypeMap.java index 56948ba..04af8ce 100644 --- a/activation/src/main/java/javax/activation/MimetypesFileTypeMap.java +++ b/activation/src/main/java/javax/activation/MimetypesFileTypeMap.java
@@ -55,7 +55,6 @@ * system for MIME types file entries. When requests are made * to search for MIME types in the MimetypesFileTypeMap, it searches * MIME types files in the following order: - * <p> * <ol> * <li> Programmatically added entries to the MimetypesFileTypeMap instance. * <li> The file <code>.mime.types</code> in the user's home directory. @@ -74,7 +73,7 @@ * * <code> * # comments begin with a '#'<br> - * # the format is <mime type> <space separated file extensions><br> + * # the format is <mime type> <space separated file extensions><br> * # for example:<br> * text/plain txt text TXT<br> * # this would map file.txt, file.text, and file.TXT to<br> @@ -274,6 +273,7 @@ * added from the named file. * * @param mimeTypeFileName the file name + * @exception IOException for errors reading the file */ public MimetypesFileTypeMap(String mimeTypeFileName) throws IOException { this();