[jackson-annotations] 07/207: ...

[Timo Aaltonen]

This is an automated email from the git hooks/post-receive script.

tjaalton pushed a commit to branch master
in repository jackson-annotations.

commit 293b9334232aa34d805440e63d301ffa88f179a1
Author: Tatu Saloranta <tsaloranta at gmail.com>
Date:   Wed Jan 11 20:51:52 2012 -0800

    ...
---
 .../java/com/fasterxml/jackson/annotation/JsonValue.java    | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/main/java/com/fasterxml/jackson/annotation/JsonValue.java b/src/main/java/com/fasterxml/jackson/annotation/JsonValue.java
index 82c6964..5fd4277 100644
--- a/src/main/java/com/fasterxml/jackson/annotation/JsonValue.java
+++ b/src/main/java/com/fasterxml/jackson/annotation/JsonValue.java
@@ -15,16 +15,17 @@ import java.lang.annotation.Target;
  * (String or Number), but it can be any serializable type (Collection,
  * Map or Bean).
  *<p>
- * At most one method of a Class can be annotated with this annotation;
+ * At most one method of a <code>Class</code> can be annotated with this annotation;
  * if more than one is found, an exception may be thrown.
  * Also, if method signature is not compatible with Getters, an exception
- * may be thrown.
- * Whether exception is thrown or not is an implementation detail (due
+ * may be thrown (whether exception is thrown or not is an implementation detail (due
  * to filtering during introspection, some annotations may be skipped)
- * and applications should not rely on specific behavior.
+ * and applications should not rely on specific behavior).
  *<p>
- * A typical use case is that of annotating <code>toString()</code>
- * method so that returned String value is Object's JSON serialization.
+ * A typical usage is that of annotating <code>toString()</code>
+ * method so that returned String value is used as the JSON serialization;
+ * and if deserialization is needed, there is matching constructor
+ * or factory method annotated with {@link JsonCreator} annotation.
  *<p>
  * Boolean argument is only used so that sub-classes can "disable"
  * annotation if necessary.

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-java/jackson-annotations.git