Some docs edits to clean up phpdoc output

Author: jeffswartz

src/OpenTok/Archive.php

@@ -218,7 +218,7 @@ public function toJson()
 
     /**
      * Adds a stream to a currently running archive that was started with the
-     * the <code>streamMode</code> set to <code>StreamMode.Manual</code>. You can call the method
+     * the streamMode set to StreamMode.Manual. You can call the method
      * repeatedly with the same stream ID, to toggle the stream's audio or video in the archive.
      * 
      * @param String $streamId The stream ID.
@@ -253,7 +253,7 @@ public function addStreamToArchive(string $streamId, bool $hasAudio, bool $hasVi
 
     /**
      * Removes a stream from a currently running archive that was started with the
-     * the <code>streamMode</code> set to <code>StreamMode.Manual</code>.
+     * the streamMode set to StreamMode.Manual.
      * 
      * @param String $streamId The stream ID.
      *

src/OpenTok/ArchiveList.php

@@ -67,6 +67,8 @@ public function totalCount()
 
     /**
      * Returns an array of Archive objects.
+     *
+     * @return Archive[]
      */
     public function getItems()
     {

src/OpenTok/Broadcast.php

@@ -165,7 +165,7 @@ public function updateLayout($layout)
 
     /**
      * Adds a stream to a currently running broadcast that was started with the
-     * the <code>streamMode</code> set to <code>StreamMode.Manual</code>. You can call the method
+     * the streamMode set to StreamMode.Manual. You can call the method
      * repeatedly with the same stream ID, to toggle the stream's audio or video in the broadcast.
      * 
      * @param String $streamId The stream ID.
@@ -200,7 +200,7 @@ public function addStreamToBroadcast(string $streamId, bool $hasAudio, bool $has
 
     /**
      * Removes a stream from a currently running broadcast that was started with the
-     * the <code>streamMode</code> set to <code>StreamMode.Manual</code>.
+     * the streamMode set to StreamMode.Manual.
      * 
      * @param String $streamId The stream ID.
      *

src/OpenTok/OpenTok.php

@@ -61,7 +61,9 @@ public function __construct($apiKey, $apiSecret, $options = array())
     }
 
     /**
-     * Creates a token for connecting to an OpenTok session. In order to authenticate a user
+     * Creates a token for connecting to an OpenTok session.
+     *
+     * In order to authenticate a user
      * connecting to an OpenTok session, the client passes a token when connecting to the session.
      * <p>
      * For testing, you generate tokens or by logging in to your
@@ -415,7 +417,9 @@ public function deleteArchive($archiveId)
     }
 
     /**
-     * Returns an ArchiveList. The <code>items()</code> method of this object returns a list of
+     * Returns a list of archives for a session.
+     *
+     * The <code>items()</code> method of this object returns a list of
      * archives that are completed and in-progress, for your API key.
      *
      * @param integer $offset Optional. The index offset of the first archive. 0 is offset of the
@@ -453,7 +457,9 @@ public function setArchiveLayout(string $archiveId, Layout $layoutType): void
     }
 
     /**
-     * Sets the layout class list for streams in a session. Layout classes are used in
+     * Sets the layout class list for streams in a session.
+     *
+     * Layout classes are used in
      * the layout for composed archives and live streaming broadcasts. For more information, see
      * <a href="https://tokbox.com/developer/guides/archiving/layout-control.html">Customizing
      * the video layout for composed archives</a> and
@@ -496,7 +502,9 @@ public function forceDisconnect($sessionId, $connectionId)
      * Force the publisher of a specific stream to mute its published audio.
      *
      * <p>
-     * Also see the <a href="#method_forceMuteAll">OpenTok->forceMuteAll()</a> method.
+     * Also see the
+     * <a href="classes/OpenTok-OpenTok.html#method_forceMuteAll">OpenTok->forceMuteAll()</a>
+     * method.
      *
      * @param string $sessionId The OpenTok session ID containing the stream.
      *
@@ -525,10 +533,12 @@ public function forceMuteStream(string $sessionId, string $streamId): bool
      * <p>
      * In addition to existing streams, any streams that are published after the call to
      * this method are published with audio muted. You can remove the mute state of a session
-     * by calling the <a href="#method_disableForceMute">OpenTok->disableForceMute()</a> method.
-     *
+     * <a href="classes/OpenTok-OpenTok.html#method_disableForceMute">OpenTok->disableForceMute()</a>
+     * method.
      * <p>
-     * Also see the <a href="#method_forceMuteStream">OpenTok->forceMuteStream()</a> method.
+     * Also see the
+     * <a href="classes/OpenTok-OpenTok.html#method_forceMuteStream">OpenTok->forceMuteStream()</a>
+     * method.
      *
      * @param string $sessionId The OpenTok session ID.
      *
@@ -564,7 +574,8 @@ public function forceMuteAll(string $sessionId, array $options): bool
      * published to the session will no longer have audio muted.
      *
      * <p>
-     * After you call the <a href="#method_forceMuteAll">OpenTok->forceMuteAll()</a> method,
+     * After you call the
+     * <a href="classes/OpenTok-OpenTok.html#method_forceMuteAll">OpenTok->forceMuteAll()</a> method
      * any streams published after the call are published with audio muted. Call the
      * <c>disableForceMute()</c> method to remove the mute state of a session, so that
      * new published streams are not automatically muted.
@@ -714,7 +725,9 @@ public function updateBroadcastLayout(string $broadcastId, Layout $layout): void
     }
 
     /**
-    * Sets the layout class list for a stream. Layout classes are used in
+    * Sets the layout class list for a stream.
+    *
+    * Layout classes are used in
     * the layout for composed archives and live streaming broadcasts.
     * <p>
     * For more information, see
@@ -725,14 +738,9 @@ public function updateBroadcastLayout(string $broadcastId, Layout $layout): void
     *
     * <p>
     * You can set the initial layout class list for streams published by a client when you generate
-    * the token used by the client to connect to the session. See the OpenTok::generateToken()
-    * {@link https://example.com/my/bar} floor
-    * ({@see OpenTok::generateToken OpenTok->generateToken()}) sdfdf
+    * the token used by the client to connect to the session. See the
     * <a href="classes/OpenTok-OpenTok.html#method_generateToken">OpenTok::generateToken()</a>
     * method.
-    * <a href="#method_generateToken">OpenTok::generateToken()</a>
-    * method. 
-    * @see OpenTok::generateToken()
     *
     * @param string $sessionId The session ID of the session the stream belongs to.
     *
@@ -819,8 +827,8 @@ public function listStreams($sessionId)
      * @param string $token The OpenTok token to be used for the participant being called.
      * You can add token data to identify that the participant is on a SIP endpoint or for
      * other identifying data, such as phone numbers. Generate a token using the
-     * <a href="#method_generateToken">OpenTok->generateToken()</a> or
-     * <a href="OpenTok.Session.html#method_generateToken">Session->generateToken()</a>
+     * <a href="classes/OpenTok-OpenTok.html#method_generateToken">OpenTok::generateToken()</a> or
+     * <a href="classes/OpenTok-Session.html#method_generateToken">Session::generateToken()</a>
      * method.
      *
      * @param string $sipUri The SIP URI to be used as destination of the SIP Call initiated from
@@ -876,7 +884,8 @@ public function listStreams($sessionId)
      * @return SipCall An object contains the OpenTok connection ID and stream ID
      * for the SIP call's connection in the OpenTok session. You can use the connection ID
      * to terminate the SIP call, using the
-     * <a href="#method_forceDisconnect">OpenTok->forceDisconnect()</a> method.
+     * <a href="classes/OpenTok-OpenTok.html#method_forceDisconnect">OpenTok::method_forceDisconnect()</a>
+     * method.
      */
     public function dial($sessionId, $token, $sipUri, $options = [])
     {

src/OpenTok/Role.php

@@ -22,7 +22,9 @@ abstract class Role extends BasicEnum
     /**
     * In addition to the privileges granted to a publisher, a moderator can perform
     * moderation functions, such as forcing clients to disconnect, to stop publishing streams,
-    * or to mute audio in published streams. See the
+    * or to mute audio in published streams.
+    *
+    * See the
     * <a href="https://tokbox.com/developer/guides/moderation/">Moderation developer guide</a>.
     */
     const MODERATOR = 'moderator';

src/OpenTok/Session.php

@@ -58,6 +58,8 @@ public function __construct($opentok, $sessionId, $properties = array())
 
     /**
     * Returns the session ID, which uniquely identifies the session.
+    *
+    * @return string
     */
     public function getSessionId()
     {
@@ -68,6 +70,8 @@ public function getSessionId()
     * Returns the location hint IP address.
     *
     * See <a href="OpenTok.OpenTok.html#method_createSession">OpenTok->createSession()</a>.
+    *
+    * @return string
     */
     public function getLocation()
     {
@@ -80,7 +84,9 @@ public function getLocation()
     * OpenTok Media Router.
     *
     * See <a href="OpenTok.OpenTok.html#method_createSession">OpenTok->createSession()</a>
-    * and <a href="OpenTok.MediaMode.html">ArchiveMode</a>.
+    * and <a href="OpenTok.MediaMode.html">MediaMode</a>.
+    *
+    * @return MediaMode
     */
     public function getMediaMode()
     {
@@ -93,6 +99,8 @@ public function getMediaMode()
     *
     * See <a href="OpenTok.OpenTok.html#method_createSession">OpenTok->createSession()</a>
     * and <a href="OpenTok.ArchiveMode.html">ArchiveMode</a>.
+    *
+    * @return ArchiveMode
     */
     public function getArchiveMode()
     {

src/OpenTok/StreamList.php

@@ -33,7 +33,7 @@ public function totalCount()
     /**
      * Returns an array of Stream objects.
      *
-     * @return array
+     * @return Stream[]
      */
     public function getItems()
     {