diff --git a/include/mbedtls/ssl.h b/include/mbedtls/ssl.h
index 8e3161c..653f857 100644
--- a/include/mbedtls/ssl.h
+++ b/include/mbedtls/ssl.h
@@ -1337,7 +1337,8 @@
 
 /**
  * \brief           Set the transport type (TLS or DTLS).
- *                  Default: TLS if both are enabled, or DTLS.
+ *                  Default: TLS if #MBEDTLS_SSL_PROTO_TLS is defined, else
+ *                  DTLS.
  *
  * \note            For DTLS, you must either provide a recv callback that
  *                  doesn't block, or one that handles timeouts, see
diff --git a/include/mbedtls/ssl_internal.h b/include/mbedtls/ssl_internal.h
index 173b6d5..511715f 100644
--- a/include/mbedtls/ssl_internal.h
+++ b/include/mbedtls/ssl_internal.h
@@ -269,8 +269,8 @@
  *
  * Goals for these helpers:
  *  - generate minimal code, eg don't test if mode is DTLS in a DTLS-only build
- *  - make the flow clear to the compiler, ie that in dual-mode builds,
- *    when there are two branchs, exactly one of them is taken
+ *  - make the flow clear to the compiler, so that in TLS and DTLS combined
+ *  builds, when there are two branches, it knows exactly one of them is taken
  *  - preserve readability
  *
  * There are three macros:
@@ -299,7 +299,7 @@
  *  #endif
  */
 #if defined(MBEDTLS_SSL_PROTO_DTLS) && defined(MBEDTLS_SSL_PROTO_TLS) /* both */
-#define MBEDTLS_SSL_TRANSPORT__BOTH /* shorcut for future tests */
+#define MBEDTLS_SSL_TRANSPORT__BOTH /* shortcut for future tests */
 #define MBEDTLS_SSL_TRANSPORT_IS_TLS( transport ) \
     ( (transport) == MBEDTLS_SSL_TRANSPORT_STREAM )
 #define MBEDTLS_SSL_TRANSPORT_IS_DTLS( transport ) \