Minor docs edits to legacy T1 token option

Author: jeffswartz

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.
      */

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)