[packages/java-gnu-mail] - fix javadoc errors - rel 3
baggins
baggins at pld-linux.org
Sun Mar 5 17:03:53 CET 2017
commit 3845f63a032348a7080e67f3d881229fa34d887a
Author: Jan Rękorajski <baggins at pld-linux.org>
Date: Sun Mar 5 17:03:40 2017 +0100
- fix javadoc errors
- rel 3
java-gnu-mail.spec | 6 +-
javadoc.patch | 920 +++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 924 insertions(+), 2 deletions(-)
---
diff --git a/java-gnu-mail.spec b/java-gnu-mail.spec
index 51180b3..178befc 100644
--- a/java-gnu-mail.spec
+++ b/java-gnu-mail.spec
@@ -2,16 +2,17 @@ Summary: GNU implementation of JavaMail API specification
Summary(pl.UTF-8): Implementacja GNU specyfikacji JavaMail
Name: java-gnu-mail
Version: 1.1.2
-Release: 2
+Release: 3
License: GPL
Group: Libraries/Java
Source0: http://ftp.gnu.org/gnu/classpathx/mail-%{version}.tar.gz
# Source0-md5: 0a94ff4328ceb6a4131be96946976a33
+Patch0: javadoc.patch
URL: http://www.gnu.org/software/classpathx/javamail/javamail.html
BuildRequires: autoconf >= 2.57
BuildRequires: automake
BuildRequires: java-gnu-activation
-BuildRequires: java-gnu-inetlib
+BuildRequires: java-gnu-inetlib >= 1.1.2-2
BuildRequires: jpackage-utils
BuildRequires: rpmbuild(macros) >= 1.300
Requires: jre
@@ -52,6 +53,7 @@ Dokumentacja API GNU JavaMail.
%prep
%setup -q -n mail-%{version}
+%patch0 -p1
%build
%{__aclocal}
diff --git a/javadoc.patch b/javadoc.patch
new file mode 100644
index 0000000..4bd0dfb
--- /dev/null
+++ b/javadoc.patch
@@ -0,0 +1,920 @@
+diff -ur mail-1.1.2/source/gnu/mail/util/QInputStream.java mail-1.1.2-javadoc/source/gnu/mail/util/QInputStream.java
+--- mail-1.1.2/source/gnu/mail/util/QInputStream.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/gnu/mail/util/QInputStream.java 2017-03-05 16:49:39.781025437 +0100
+@@ -55,6 +55,7 @@
+ * characters. (But see section 5 for restrictions.) In
+ * particular, SPACE and TAB MUST NOT be represented as themselves
+ * within encoded words.
++ * </ol>
+ *
+ * @author <a href="mailto:dog at gnu.org">Chris Burdess</a>
+ */
+diff -ur mail-1.1.2/source/gnu/mail/util/QOutputStream.java mail-1.1.2-javadoc/source/gnu/mail/util/QOutputStream.java
+--- mail-1.1.2/source/gnu/mail/util/QOutputStream.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/gnu/mail/util/QOutputStream.java 2017-03-05 16:50:08.121375407 +0100
+@@ -82,6 +82,7 @@
+ * characters. (But see section 5 for restrictions.) In
+ * particular, SPACE and TAB MUST NOT be represented as themselves
+ * within encoded words.
++ * </ol>
+ *
+ * @author <a href="mailto:dog at gnu.org">Chris Burdess</a>
+ */
+diff -ur mail-1.1.2/source/javax/mail/event/TransportEvent.java mail-1.1.2-javadoc/source/javax/mail/event/TransportEvent.java
+--- mail-1.1.2/source/javax/mail/event/TransportEvent.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/event/TransportEvent.java 2017-03-05 16:53:41.550682300 +0100
+@@ -68,7 +68,7 @@
+
+ /**
+ * Constructor.
+- * @param source the transport
++ * @param transport the transport
+ * @param type the event type
+ * @param validSent the valid sent addresses
+ * @param validUnsent the valid unsent addresses
+diff -ur mail-1.1.2/source/javax/mail/Folder.java mail-1.1.2-javadoc/source/javax/mail/Folder.java
+--- mail-1.1.2/source/javax/mail/Folder.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/Folder.java 2017-03-05 17:00:15.092231810 +0100
+@@ -577,7 +577,7 @@
+
+ /**
+ * Sets the specified flags on each specified message.
+- * @param msgnums the messages
++ * @param msgs the messages
+ * @param flag the flags to be set
+ * @param value set the flags to this value
+ * @exception IllegalStateException if this folder is closed or READ_ONLY
+@@ -694,7 +694,7 @@
+ * Searches this folder for messages matching the specified search term.
+ * Returns the matching messages.
+ * @param term the search term
+- * @exception SearchException if there was a problem with the search
++ * @exception javax.mail.search.SearchException if there was a problem with the search
+ * @exception FolderNotFoundException if this folder does not exist
+ * @exception IllegalStateException if this folder is closed
+ */
+@@ -710,7 +710,7 @@
+ * Returns the matching messages.
+ * @param term the search term
+ * @param msgs the messages to be searched
+- * @exception SearchException if there was a problem with the search
++ * @exception javax.mail.search.SearchException if there was a problem with the search
+ * @exception IllegalStateException if this folder is closed
+ */
+ public Message[] search(SearchTerm term, Message[] msgs)
+diff -ur mail-1.1.2/source/javax/mail/internet/HeaderTokenizer.java mail-1.1.2-javadoc/source/javax/mail/internet/HeaderTokenizer.java
+--- mail-1.1.2/source/javax/mail/internet/HeaderTokenizer.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/internet/HeaderTokenizer.java 2017-03-05 16:53:19.507075949 +0100
+@@ -223,7 +223,7 @@
+ * by <code>next()</code>.
+ * Invoking this method multiple times returns successive tokens,
+ * until <code>next()</code> is called.
+- * @param ParseException if the parse fails
++ * @exception ParseException if the parse fails
+ */
+ public Token peek()
+ throws ParseException
+diff -ur mail-1.1.2/source/javax/mail/internet/InternetAddress.java mail-1.1.2-javadoc/source/javax/mail/internet/InternetAddress.java
+--- mail-1.1.2/source/javax/mail/internet/InternetAddress.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/internet/InternetAddress.java 2017-03-05 16:53:02.153527732 +0100
+@@ -208,7 +208,7 @@
+ * the specified charset as per RFC 2047.
+ * @param name the personal name
+ * @param charset the charset to be used for any encoding
+- * @param UnsupportedEncodingException if charset encoding fails
++ * @exception UnsupportedEncodingException if charset encoding fails
+ */
+ public void setPersonal(String name, String charset)
+ throws UnsupportedEncodingException
+diff -ur mail-1.1.2/source/javax/mail/internet/MimeBodyPart.java mail-1.1.2-javadoc/source/javax/mail/internet/MimeBodyPart.java
+--- mail-1.1.2/source/javax/mail/internet/MimeBodyPart.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/internet/MimeBodyPart.java 2017-03-05 16:45:12.271065297 +0100
+@@ -277,7 +277,7 @@
+
+ /**
+ * Sets the Content-Disposition header field of this part.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -349,7 +349,7 @@
+
+ /**
+ * Sets the Content-ID header field of this part.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -379,7 +379,7 @@
+
+ /**
+ * Sets the Content-MD5 header field of this part.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -429,7 +429,7 @@
+ /**
+ * Sets the Content-Language header of this part.
+ * @param languages the array of language tags
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -484,7 +484,7 @@
+ * If <code>description</code> contains non US-ASCII characters, it will
+ * be encoded using the platform default charset.
+ * @param description the content description
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -502,7 +502,7 @@
+ * be encoded using the specified charset.
+ * @param description the content description
+ * @param charset the charset used for encoding
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -579,7 +579,7 @@
+
+ /**
+ * Sets the filename associated with this body part.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -693,7 +693,7 @@
+
+ /**
+ * Sets the content of this part using the specified data handler.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -714,7 +714,7 @@
+ * installed and accept objects of the type given.
+ * @param o the content object
+ * @param type the MIME type of the object
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -795,7 +795,7 @@
+ /**
+ * Sets the content of this part to be the specified multipart.
+ * @param mp the multipart content
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -896,7 +896,7 @@
+ * Sets the specified header.
+ * @param name the header name
+ * @param value the header value
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -911,7 +911,7 @@
+ * Adds the specified header.
+ * @param name the header name
+ * @param value the header value
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -925,7 +925,7 @@
+ /**
+ * Removes all headers with the specified name.
+ * @param name the header name
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -968,7 +968,7 @@
+
+ /**
+ * Adds an RFC 822 header-line to this part.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+@@ -1011,7 +1011,7 @@
+
+ /**
+ * Updates the headers of this part, based on the content.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this body part is obtained
+ * from a READ_ONLY folder
+diff -ur mail-1.1.2/source/javax/mail/internet/MimeMessage.java mail-1.1.2-javadoc/source/javax/mail/internet/MimeMessage.java
+--- mail-1.1.2/source/javax/mail/internet/MimeMessage.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/internet/MimeMessage.java 2017-03-05 16:45:12.274398671 +0100
+@@ -344,7 +344,7 @@
+ /**
+ * Sets the RFC 822 From header field.
+ * @param address the sender of this message
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -365,7 +365,7 @@
+ /**
+ * Sets the RFC 822 From header field using the value of the
+ * <code>InternetAddress.getLocalAddress</code> method.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -388,7 +388,7 @@
+ /**
+ * Adds the specified addresses to From header field.
+ * @param addresses the senders of this message
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -420,7 +420,7 @@
+ /**
+ * Sets the RFC 822 Sender header field.
+ * @param address the sender of this message
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -484,7 +484,7 @@
+ * @param type the recipient type
+ * @param addresses the addresses, or null to remove recipients of this
+ * type
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -514,7 +514,7 @@
+ * @param type the recipient type
+ * @param addresses the addresses, or null to remove recpients of this
+ * type
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -544,7 +544,7 @@
+ * Adds the given addresses to the recipients of the specified type.
+ * @param type the recipient type
+ * @param addresses the addresses
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -570,7 +570,7 @@
+ * Adds the given addresses to the recipients of the specified type.
+ * @param type the recipient type
+ * @param addresses the addresses
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -612,7 +612,7 @@
+ * Sets the RFC 822 Reply-To header field.
+ * @param addresses the addresses, or <code>null</code> to remove this
+ * header
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -717,7 +717,7 @@
+ * If the subject contains non US-ASCII characters, it will be encoded
+ * using the platform default charset.
+ * @param subject the subject
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -735,7 +735,7 @@
+ * using the specified charset.
+ * @param subject the subject
+ * @param charset the charset used for any encoding
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -782,7 +782,7 @@
+ /**
+ * Sets the RFC 822 Date header field.
+ * @param date the sent date, or <code>null</code> to remove this header
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -903,7 +903,7 @@
+ /**
+ * Sets the Content-Disposition header field of this message.
+ * @param disposition the disposition value to set, or null to remove
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -979,7 +979,7 @@
+
+ /**
+ * Sets the Content-ID header field of this message.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1009,7 +1009,7 @@
+
+ /**
+ * Sets the Content-MD5 header field of this message.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1052,7 +1052,7 @@
+ * If the description contains non US-ASCII characters, it will be encoded
+ * using the platform default charset.
+ * @param description the content description
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1071,7 +1071,7 @@
+ * using the specified charset.
+ * @param description the content description
+ * @param charset the charset used for any encoding
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1138,7 +1138,7 @@
+ /**
+ * Sets the Content-Language header of this message.
+ * @param languages the array of language tags
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1219,7 +1219,7 @@
+
+ /**
+ * Sets the filename associated with this part.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1334,7 +1334,7 @@
+
+ /**
+ * Sets the content of this part using the specified data handler.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1357,7 +1357,7 @@
+ * installed and accept objects of the type given.
+ * @param o the content object
+ * @param type the MIME type of the object
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1435,7 +1435,7 @@
+ /**
+ * Sets the content of this message to be the specified multipart.
+ * @param mp the multipart content
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1674,7 +1674,7 @@
+ * Sets the specified header.
+ * @param name the header name
+ * @param value the header value
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1689,7 +1689,7 @@
+ * Adds the specified header.
+ * @param name the header name
+ * @param value the header value
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1703,7 +1703,7 @@
+ /**
+ * Removes all headers with the specified name.
+ * @param name the header name
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1746,7 +1746,7 @@
+
+ /**
+ * Adds an RFC 822 header-line to this message.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1808,7 +1808,7 @@
+
+ /**
+ * Sets the flags for this message.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1830,7 +1830,7 @@
+ * Saves any changes to this message.
+ * Header fields in the message are updated appropriately to be consistent
+ * with the message contents.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+@@ -1845,7 +1845,7 @@
+
+ /**
+ * Updates the headers of this part, based on the content.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder
+diff -ur mail-1.1.2/source/javax/mail/internet/MimePart.java mail-1.1.2-javadoc/source/javax/mail/internet/MimePart.java
+--- mail-1.1.2/source/javax/mail/internet/MimePart.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/internet/MimePart.java 2017-03-05 16:52:40.973265522 +0100
+@@ -59,7 +59,7 @@
+
+ /**
+ * Adds an RFC822 header-line.
+- * @exception IllegalWriteException if the underlying implementation does not
++ * @exception javax.mail.IllegalWriteException if the underlying implementation does not
+ * support modification
+ * @exception IllegalStateException if this part is obtained from a READ_ONLY
+ * folder
+@@ -109,9 +109,9 @@
+
+ /**
+ * Sets the Content-MD5 header value for this part.
+- * @exception IllegalWriteException if the underlying implementation does not
++ * @exception javax.mail.IllegalWriteException if the underlying implementation does not
+ * support modification
+- * @param IllegalStateException if this part is obtained from a READ_ONLY
++ * @exception IllegalStateException if this part is obtained from a READ_ONLY
+ * folder
+ */
+ void setContentMD5(String md5)
+@@ -128,7 +128,7 @@
+ /**
+ * Sets the Content-Language header of this part.
+ * @param languages the array of language tags
+- * @exception IllegalWriteException if the underlying implementation does not
++ * @exception javax.mail.IllegalWriteException if the underlying implementation does not
+ * support modification
+ * @exception IllegalStateException if this Part is obtained from a READ_ONLY
+ * folder
+diff -ur mail-1.1.2/source/javax/mail/internet/MimeUtility.java mail-1.1.2-javadoc/source/javax/mail/internet/MimeUtility.java
+--- mail-1.1.2/source/javax/mail/internet/MimeUtility.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/internet/MimeUtility.java 2017-03-05 16:51:58.039400881 +0100
+@@ -82,6 +82,7 @@
+ * <li>If the primary type of this datasource is not "text", then if all the
+ * bytes of its input stream are US-ASCII, the encoding is "7bit". If
+ * there is even one non-US-ASCII character, the encoding is "base64".
++ * </ul>
+ * @param ds the data source
+ * @return "7bit", "quoted-printable" or "base64"
+ */
+@@ -285,7 +286,7 @@
+ * Encodes an RFC 822 "text" token into mail-safe form according to
+ * RFC 2047.
+ * @param text the Unicode string
+- * @param UnsupportedEncodingException if the encoding fails
++ * @exception UnsupportedEncodingException if the encoding fails
+ */
+ public static String encodeText(String text)
+ throws UnsupportedEncodingException
+@@ -530,7 +531,7 @@
+ /**
+ * Decodes the specified string using the RFC 2047 rules for parsing an
+ * "encoded-word".
+- * @param eword the possibly encoded value
++ * @param text the possibly encoded value
+ * @exception ParseException if the string is not an encoded-word
+ * @exception UnsupportedEncodingException if the decoding failed
+ */
+@@ -706,7 +707,7 @@
+ * <p>
+ * The HeaderTokenizer class defines two "specials" lists,
+ * MIME and RFC 822.
+- * @param word the word to be quoted
++ * @param text the word to be quoted
+ * @param specials the set of special characters
+ */
+ public static String quote(String text, String specials)
+diff -ur mail-1.1.2/source/javax/mail/Message.java mail-1.1.2-javadoc/source/javax/mail/Message.java
+--- mail-1.1.2/source/javax/mail/Message.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/Message.java 2017-03-05 16:45:12.274398671 +0100
+@@ -181,7 +181,7 @@
+ * Sets the identity of the person sending this message, as obtained
+ * from the property "mail.user".
+ * If this property is absent, the system property "user.name" is used.
+- * @exception IllegalWriteException if the underlying implementation does
++ * @exception javax.mail.IllegalWriteException if the underlying implementation does
+ * not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from a
+ * READ_ONLY folder
+@@ -192,7 +192,7 @@
+ /**
+ * Sets the identity of the person sending this message.
+ * @param address the sender
+- * @exception IllegalWriteException if the underlying implementation does
++ * @exception javax.mail.IllegalWriteException if the underlying implementation does
+ * not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from a
+ * READ_ONLY folder.
+@@ -203,7 +203,7 @@
+ /**
+ * Adds addresses to the identity of the person sending this message.
+ * @param addresses the senders
+- * @exception IllegalWriteException if the underlying implementation does
++ * @exception javax.mail.IllegalWriteException if the underlying implementation does
+ * not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from a
+ * READ_ONLY folder.
+@@ -258,7 +258,7 @@
+ * Sets the recipient addresses of the specified type.
+ * @param type the recipient type
+ * @param addresses the addresses
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder.
+@@ -268,7 +268,7 @@
+
+ /**
+ * Sets the recipient address of the specified type.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ */
+ public void setRecipient(RecipientType type, Address address)
+@@ -281,7 +281,7 @@
+ * Adds the recipient addresses of the given type.
+ * @param type the recipient type
+ * @param addresses the addresses
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder.
+@@ -291,7 +291,7 @@
+
+ /**
+ * Adds the recipient address of the given type.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ */
+ public void addRecipient(RecipientType type, Address address)
+@@ -328,7 +328,7 @@
+ /**
+ * Sets the subject of this message.
+ * @param subject the subject
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder.
+@@ -345,7 +345,7 @@
+ /**
+ * Sets the date this message was sent.
+ * @param date the sent date of this message
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder.
+@@ -384,7 +384,7 @@
+ * are unaffected.
+ * @param flag the flags to be set
+ * @param set the value to be set
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder.
+@@ -396,7 +396,7 @@
+ * Sets the specified flag on this message to the given value.
+ * @param flag the flag to be set
+ * @param set the value to be set
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder.
+@@ -470,7 +470,7 @@
+ * <p>
+ * This method ensures that any header fields are consistent with the
+ * changed message contents.
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ * @exception IllegalStateException if this message is obtained from
+ * a READ_ONLY folder.
+diff -ur mail-1.1.2/source/javax/mail/Multipart.java mail-1.1.2-javadoc/source/javax/mail/Multipart.java
+--- mail-1.1.2/source/javax/mail/Multipart.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/Multipart.java 2017-03-05 16:45:12.274398671 +0100
+@@ -126,7 +126,7 @@
+ * @param part the body part to remove
+ * @return true if a body part was removed, false otherwise
+ * @exception MessagingException if the multipart has not been configured
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ */
+ public boolean removeBodyPart(BodyPart part)
+@@ -152,7 +152,7 @@
+ * The body parts in this container are numbered starting at 0.
+ * @param index index of the part to remove
+ * @exception IndexOutOfBoundsException if the given index is out of range
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ */
+ public void removeBodyPart(int index)
+@@ -173,7 +173,7 @@
+ /**
+ * Adds a body part to this multipart.
+ * @param part the body part to be appended
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ */
+ public synchronized void addBodyPart(BodyPart part)
+@@ -195,7 +195,7 @@
+ * The body parts in this container are numbered starting at 0.
+ * @param part the body part to be inserted
+ * @param index where to insert the part
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of existing values
+ */
+ public synchronized void addBodyPart(BodyPart part, int index)
+diff -ur mail-1.1.2/source/javax/mail/Part.java mail-1.1.2-javadoc/source/javax/mail/Part.java
+--- mail-1.1.2/source/javax/mail/Part.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/Part.java 2017-03-05 16:45:12.274398671 +0100
+@@ -117,7 +117,7 @@
+ /**
+ * Sets the disposition of this part.
+ * @param disposition the disposition of this part
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of this header
+ * @exception IllegalStateException if this part is obtained from
+ * a READ_ONLY folder
+@@ -134,7 +134,7 @@
+ /**
+ * Sets the description of this part.
+ * @param description the description of this part
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of this header
+ * @exception IllegalStateException if this Part is obtained from
+ * a READ_ONLY folder
+@@ -151,7 +151,7 @@
+ /**
+ * Sets the filename associated with this part.
+ * @param filename the filename to associate with this part
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of this header
+ * @exception IllegalStateException if this Part is obtained from
+ * a READ_ONLY folder
+@@ -189,7 +189,7 @@
+ /**
+ * Sets the content of this part using the specified data handler.
+ * @param dh the data handler for the content
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this part is obtained from
+ * a READ_ONLY folder
+@@ -202,7 +202,7 @@
+ * the supplied argument must be known to the data handler system.
+ * @param obj a Java object
+ * @param type the MIME content-type of this object
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this part is obtained from
+ * a READ_ONLY folder
+@@ -214,7 +214,7 @@
+ * Sets the textual content of this part, using a MIME type of
+ * <code>text/plain</code>.
+ * @param text the textual content
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this part is obtained from
+ * a READ_ONLY folder
+@@ -225,7 +225,7 @@
+ /**
+ * Sets the multipart content of this part.
+ * @param mp the multipart content
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification
+ * @exception IllegalStateException if this part is obtained from
+ * a READ_ONLY folder
+@@ -255,7 +255,7 @@
+ * Sets the value for the specified header name.
+ * @param name the header name
+ * @param value the new value
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of this header
+ * @exception IllegalStateException if this part is obtained from
+ * a READ_ONLY folder
+@@ -267,7 +267,7 @@
+ * Adds the specified value to the existing values for this header name.
+ * @param name the header name
+ * @param value the value to add
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of this header
+ * @exception IllegalStateException if this part is obtained from
+ * a READ_ONLY folder
+@@ -278,7 +278,7 @@
+ /**
+ * Removes all headers of the specified name.
+ * @param name the header name
+- * @exception IllegalWriteException if the underlying implementation
++ * @exception javax.mail.IllegalWriteException if the underlying implementation
+ * does not support modification of this header
+ * @exception IllegalStateException if this part is obtained from
+ * a READ_ONLY folder
+diff -ur mail-1.1.2/source/javax/mail/QuotaAwareStore.java mail-1.1.2-javadoc/source/javax/mail/QuotaAwareStore.java
+--- mail-1.1.2/source/javax/mail/QuotaAwareStore.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/QuotaAwareStore.java 2017-03-05 16:58:25.584205083 +0100
+@@ -29,9 +29,9 @@
+
+ /**
+ * Interface implemented by mail stores that support quotas.
++ * see RFC 2087
+ *
+ * @author <a href="mailto:dog at gnu.org">Chris Burdess</a>
+- * @see RFC 2087
+ * @version 1.4
+ * @since JavaMail 1.4
+ */
+diff -ur mail-1.1.2/source/javax/mail/Quota.java mail-1.1.2-javadoc/source/javax/mail/Quota.java
+--- mail-1.1.2/source/javax/mail/Quota.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/Quota.java 2017-03-05 16:58:35.470994505 +0100
+@@ -29,9 +29,9 @@
+
+ /**
+ * A set of quotas for a given quota root.
++ * see RFC 2087
+ *
+ * @author <a href="mailto:dog at gnu.org">Chris Burdess</a>
+- * @see RFC 2087
+ * @version 1.4
+ * @since JavaMail 1.4
+ */
+diff -ur mail-1.1.2/source/javax/mail/search/FromStringTerm.java mail-1.1.2-javadoc/source/javax/mail/search/FromStringTerm.java
+--- mail-1.1.2/source/javax/mail/search/FromStringTerm.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/search/FromStringTerm.java 2017-03-05 16:50:26.791606050 +0100
+@@ -42,7 +42,7 @@
+
+ /**
+ * Constructor.
+- * @param address the address pattern for comparison
++ * @param pattern the address pattern for comparison
+ */
+ public FromStringTerm(String pattern)
+ {
+diff -ur mail-1.1.2/source/javax/mail/search/RecipientStringTerm.java mail-1.1.2-javadoc/source/javax/mail/search/RecipientStringTerm.java
+--- mail-1.1.2/source/javax/mail/search/RecipientStringTerm.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/search/RecipientStringTerm.java 2017-03-05 16:51:31.359070860 +0100
+@@ -48,7 +48,7 @@
+ /**
+ * Constructor.
+ * @param type the recipient type
+- * @param address the address pattern for comparison
++ * @param pattern the address pattern for comparison
+ */
+ public RecipientStringTerm(Message.RecipientType type, String pattern)
+ {
+diff -ur mail-1.1.2/source/javax/mail/Session.java mail-1.1.2-javadoc/source/javax/mail/Session.java
+--- mail-1.1.2/source/javax/mail/Session.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/Session.java 2017-03-05 16:57:56.777180784 +0100
+@@ -457,7 +457,7 @@
+ * If an implementation for the protocol isn't found,
+ * throws NoSuchProviderException
+ * @param protocol Configured protocol(i.e. smtp, imap, etc)
+- * @param NoSuchProviderException If a provider for the given protocol
++ * @exception NoSuchProviderException If a provider for the given protocol
+ * is not found.
+ */
+ public Provider getProvider(String protocol)
+@@ -676,7 +676,7 @@
+ * @param url URLName that represents the desired folder
+ * @exception NoSuchProviderException If a provider for the given URLName
+ * is not found.
+- * @param MessagingException if the Folder could not be located or created.
++ * @exception MessagingException if the Folder could not be located or created.
+ */
+ public Folder getFolder(URLName url)
+ throws MessagingException
+@@ -784,12 +784,14 @@
+ * Call back to the application to get the needed user name and password.
+ * The application should put up a dialog something like:
+ * <pre>
+- Connecting to <protocol> mail service on host <addr>, port <port>.
+- <prompt>
++ Connecting to protocol mail service on host addr, port port.
++ prompt
+
+- User Name: <defaultUserName>
++ User Name: defaultUserName
+ Password:
+- * @param addr InetAddress of the host. may be null.
++ * </pre>
++ * @param address InetAddress of the host. may be null.
++ * @param port InetAddress port of the host. may be null.
+ * @param protocol protocol scheme(e.g. imap, pop3, etc.)
+ * @param prompt any additional String to show as part of the prompt; may be
+ * null.
+diff -ur mail-1.1.2/source/javax/mail/StoreClosedException.java mail-1.1.2-javadoc/source/javax/mail/StoreClosedException.java
+--- mail-1.1.2/source/javax/mail/StoreClosedException.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/StoreClosedException.java 2017-03-05 16:54:27.544585491 +0100
+@@ -31,7 +31,7 @@
+ * An exception thrown when a method is invoked on a message or folder
+ * whose owner store has been closed for some reason.
+ * <p>
+- * The <code>connect</connect> method may be invoked on the store object to
++ * The <code>connect</code> method may be invoked on the store object to
+ * reconnect, but any references to existing folders and messages should be
+ * considered invalid.
+ *
+diff -ur mail-1.1.2/source/javax/mail/UIDFolder.java mail-1.1.2-javadoc/source/javax/mail/UIDFolder.java
+--- mail-1.1.2/source/javax/mail/UIDFolder.java 2007-04-28 20:52:58.000000000 +0200
++++ mail-1.1.2-javadoc/source/javax/mail/UIDFolder.java 2017-03-05 16:54:07.407669298 +0100
+@@ -39,7 +39,7 @@
+ * than the message number of message <i>y</i>, its UID will also be greater
+ * than that of <i>y</i>.
+ *
+- * @see RFC 2060 http://www.ietf.org/rfc/rfc2060.txt
++ * RFC 2060 http://www.ietf.org/rfc/rfc2060.txt
+ * @author <a href="mailto:dog at gnu.org">Chris Burdess</a>
+ * @version 1.4
+ */
================================================================
---- gitweb:
http://git.pld-linux.org/gitweb.cgi/packages/java-gnu-mail.git/commitdiff/3845f63a032348a7080e67f3d881229fa34d887a
More information about the pld-cvs-commit
mailing list