Clarify documentation for nested EAP-TTLS sessions.
Bug: 173122059
Test: compiles
Change-Id: I6c635f82d242bb54d30141060476da956d386dc9
diff --git a/src/java/android/net/eap/EapSessionConfig.java b/src/java/android/net/eap/EapSessionConfig.java
index aeea7bc..7342dd1 100644
--- a/src/java/android/net/eap/EapSessionConfig.java
+++ b/src/java/android/net/eap/EapSessionConfig.java
@@ -309,7 +309,9 @@
/**
* Sets the configuration for EAP-TTLS.
*
- * <p>Tunneled EAP-TTLS authentications are disallowed.
+ * <p>Tunneled EAP-TTLS authentications are disallowed, as running multiple layers of
+ * EAP-TTLS increases the data footprint but has no discernible benefits over a single
+ * EAP-TTLS session with a non EAP-TTLS method nested inside it.
*
* @param serverCaCert the CA certificate for validating the received server certificate(s).
* If a certificate is provided, it MUST be the root CA used by the server, or
