javadoc improvements for #1222
diff --git a/src/main/java/com/fasterxml/jackson/databind/type/TypeFactory.java b/src/main/java/com/fasterxml/jackson/databind/type/TypeFactory.java
index 88def8c..dc9583a 100644
--- a/src/main/java/com/fasterxml/jackson/databind/type/TypeFactory.java
+++ b/src/main/java/com/fasterxml/jackson/databind/type/TypeFactory.java
@@ -796,12 +796,17 @@
}
/**
- * Method that will force construction of a simple type, without trying to
- * check for more specialized types.
+ * Method that use by core Databind functionality, and that should NOT be called
+ * by application code outside databind package.
*<p>
- * NOTE: no type modifiers are called on type either, so calling this method
- * should only be used if caller really knows what it's doing...
+ * Unchecked here not only means that no checks are made as to whether given class
+ * might be non-simple type (like {@link CollectionType}) but also that most of supertype
+ * information is not gathered. This means that unless called on primitive types or
+ * {@link java.lang.String}, results are probably not what you want to use.
+ *
+ * @deprecated Since 2.8, to indicate users should never call this method.
*/
+ @Deprecated // since 2.8
public JavaType uncheckedSimpleType(Class<?> cls) {
// 18-Oct-2015, tatu: Not sure how much problem missing super-type info is here
return _constructSimple(cls, EMPTY_BINDINGS, null, null);