You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ch...@apache.org on 2016/06/14 04:18:55 UTC

[lang] update javadoc for DateParser and DatePrinter

Repository: commons-lang
Updated Branches:
  refs/heads/master d2fb3b086 -> 6f318c10a


update javadoc for DateParser and DatePrinter


Project: http://git-wip-us.apache.org/repos/asf/commons-lang/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-lang/commit/6f318c10
Tree: http://git-wip-us.apache.org/repos/asf/commons-lang/tree/6f318c10
Diff: http://git-wip-us.apache.org/repos/asf/commons-lang/diff/6f318c10

Branch: refs/heads/master
Commit: 6f318c10aaa996ed72464b36f5b235601ce7e971
Parents: d2fb3b0
Author: Chas Honton <ch...@apache.org>
Authored: Sun Jun 12 17:34:33 2016 -0700
Committer: Chas Honton <ch...@apache.org>
Committed: Mon Jun 13 21:17:26 2016 -0700

----------------------------------------------------------------------
 .../java/org/apache/commons/lang3/time/DateParser.java    | 10 ++++++++--
 .../java/org/apache/commons/lang3/time/DatePrinter.java   |  8 ++++++--
 2 files changed, 14 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-lang/blob/6f318c10/src/main/java/org/apache/commons/lang3/time/DateParser.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/time/DateParser.java b/src/main/java/org/apache/commons/lang3/time/DateParser.java
index c91f9a2..6313452 100644
--- a/src/main/java/org/apache/commons/lang3/time/DateParser.java
+++ b/src/main/java/org/apache/commons/lang3/time/DateParser.java
@@ -24,8 +24,12 @@ import java.util.Locale;
 import java.util.TimeZone;
 
 /**
- * <p>DateParser is the "missing" interface for the parsing methods of 
- * {@link java.text.DateFormat}.</p>
+ * DateParser is the "missing" interface for the parsing methods of
+ * {@link java.text.DateFormat}. You can obtain an object implementing this
+ * interface by using one of the FastDateFormat factory methods.
+ * <p>
+ * Warning: Since binary compatible methods may be added to this interface in any
+ * release, developers are not expected to implement this interface.
  * 
  * @since 3.2
  */
@@ -66,6 +70,8 @@ public interface DateParser {
      * @return true, if source has been parsed (pos parsePosition is updated); otherwise false (and pos errorIndex is updated)
      * @throws IllegalArgumentException when Calendar has been set to be not lenient, and a parsed field is
      * out of range.
+     * 
+     * @since 3.5
      */
     boolean parse(String source, ParsePosition pos, Calendar calendar);
 

http://git-wip-us.apache.org/repos/asf/commons-lang/blob/6f318c10/src/main/java/org/apache/commons/lang3/time/DatePrinter.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/lang3/time/DatePrinter.java b/src/main/java/org/apache/commons/lang3/time/DatePrinter.java
index 8f42ec7..5bf393b 100644
--- a/src/main/java/org/apache/commons/lang3/time/DatePrinter.java
+++ b/src/main/java/org/apache/commons/lang3/time/DatePrinter.java
@@ -23,8 +23,12 @@ import java.util.Locale;
 import java.util.TimeZone;
 
 /**
- * <p>DatePrinter is the "missing" interface for the format methods of 
- * {@link java.text.DateFormat}.</p>
+ * DatePrinter is the "missing" interface for the format methods of 
+ * {@link java.text.DateFormat}. You can obtain an object implementing this
+ * interface by using one of the FastDateFormat factory methods.
+ * <p>
+ * Warning: Since binary compatible methods may be added to this interface in any
+ * release, developers are not expected to implement this interface.
  * 
  * @since 3.2
  */