diff --git a/gson/src/main/java/com/google/gson/Gson.java b/gson/src/main/java/com/google/gson/Gson.java
index 262cd175..8a26760f 100644
--- a/gson/src/main/java/com/google/gson/Gson.java
+++ b/gson/src/main/java/com/google/gson/Gson.java
@@ -155,14 +155,18 @@ public final class Gson {
private static final String JSON_NON_EXECUTABLE_PREFIX = ")]}'\n";
/**
- * This thread local guards against reentrant calls to getAdapter(). In
- * certain object graphs, creating an adapter for a type may recursively
+ * This thread local guards against reentrant calls to {@link #getAdapter(TypeToken)}.
+ * In certain object graphs, creating an adapter for a type may recursively
* require an adapter for the same type! Without intervention, the recursive
- * lookup would stack overflow. We cheat by returning a proxy type adapter.
- * The proxy is wired up once the initial adapter has been created.
+ * lookup would stack overflow. We cheat by returning a proxy type adapter,
+ * {@link FutureTypeAdapter}, which is wired up once the initial adapter has
+ * been created.
+ *
+ *
The map stores the type adapters for ongoing {@code getAdapter} calls,
+ * with the type token provided to {@code getAdapter} as key and either
+ * {@code FutureTypeAdapter} or a regular {@code TypeAdapter} as value.
*/
- private final ThreadLocal