[jackson-annotations] 139/207: Clarify comments on JsonTypeInfo.As.EXISTING_PROPERTY a bit.

[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 9434c1d14355779db7957ad09d2df0a6bfbf4766
Author: Tatu Saloranta <tatu.saloranta at iki.fi>
Date:   Wed Jul 24 22:47:44 2013 -0700

    Clarify comments on JsonTypeInfo.As.EXISTING_PROPERTY a bit.
---
 src/main/java/com/fasterxml/jackson/annotation/JsonTypeInfo.java | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/main/java/com/fasterxml/jackson/annotation/JsonTypeInfo.java b/src/main/java/com/fasterxml/jackson/annotation/JsonTypeInfo.java
index 9d33c77..73a7757 100644
--- a/src/main/java/com/fasterxml/jackson/annotation/JsonTypeInfo.java
+++ b/src/main/java/com/fasterxml/jackson/annotation/JsonTypeInfo.java
@@ -178,6 +178,12 @@ public @interface JsonTypeInfo
          * will do nothing, and expect a property with defined name to be output
          * using some other mechanism (like default POJO property serialization, or
          * custom serializer).
+         *<p>
+         * Note that this behavior is quite similar to that of using {@link JsonTypeId};
+         * except that here <code>TypeSerializer</code> is basically suppressed;
+         * whereas with {@link JsonTypeId}, output of regular property is suppressed.
+         * This mostly matters with respect to output order; this choice is the only
+         * way to ensure specific placement of type id during serialization.
          * 
          * @since 2.3.0
          */

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