diff --git a/src/OpenTok/OpenTok.php b/src/OpenTok/OpenTok.php
index c902734..ad99cdc 100644
--- a/src/OpenTok/OpenTok.php
+++ b/src/OpenTok/OpenTok.php
@@ -131,8 +131,8 @@ public function __construct($apiKey, $apiSecret, $options = array())
      *
      * </ul>
      *
-     * @param bool $legacy By default, OpenTok uses SHA256 JWTs for authentication. Switching
-     * legacy to true will create a T1 token for backwards compatibility.
+     * @param bool $legacy Connection tokens are now SHA-256 signed JWTs.
+     * Set this to <code>true</code> to create a token using the legacy T1 format.
      *
      * @return string The token string.
      */
diff --git a/src/OpenTok/Session.php b/src/OpenTok/Session.php
index c9b437c..159f69e 100644
--- a/src/OpenTok/Session.php
+++ b/src/OpenTok/Session.php
@@ -152,6 +152,9 @@ public function __toString()
      *
      * </ul>
      *
+     * @param bool $legacy Connection tokens are now SHA-256 signed JWTs.
+     * Set this to <code>true</code> to create a token using the legacy T1 format.
+     *
      * @return string The token string.
      */
     public function generateToken($options = array(), bool $legacy = false)