Docs edits for hasAudio/hasVideo (startArchive).

And other minor docs edits.

Author: jeffswartz

README.md

@@ -6,7 +6,7 @@ The OpenTok Java SDK lets you generate
 [sessions](http://tokbox.com/opentok/tutorials/create-session/) and
 [tokens](http://tokbox.com/opentok/tutorials/create-token/) for [OpenTok](http://www.tokbox.com/)
 applications that run on the JVM. This version of the SDK also includes support for working
-with [OpenTok 2.0 archives](http://tokbox.com/#archiving).
+with [OpenTok archives](http://tokbox.com/#archiving).
 
 If you are updating from a previous version of this SDK, see
 [Important changes since v2.2.0](#important-changes-since-v220).
@@ -143,6 +143,19 @@ Archive archive = opentok.startArchive(sessionId, null);
 String archiveId = archive.getId();
 ```
 
+You can also disable audio or video recording by setting the `hasAudio` or `hasVideo` parameters of
+the `startArchive(String sessionId, String name, boolean hasVideo, boolean hasAudio` method to `false`:
+
+```java
+import com.opentok.Archive;
+
+// Start an audio-only archive
+Archive archive = opentok.startArchive(sessionId, null, false, true);
+
+// Store this archiveId in the database for later use
+String archiveId = archive.getId();
+```
+
 You can stop the recording of a started Archive using a `com.opentok.Archive` instance's
 `stopArchive(String archiveId)` method.
 
@@ -221,8 +234,7 @@ OpenTok TURN server to relay audio-video streams.
 
 **Changes in v2.2.0:**
 
-This version of the SDK includes support for working with OpenTok 2.0 archives. (This API does not
-work with OpenTok 1.0 archives.)
+This version of the SDK includes support for working with OpenTok archives.
 
 This version of the SDK includes a number of improvements in the API design. These include a number
 of API changes. See the OpenTok 2.2 SDK Reference for details on the new API.

src/main/java/com/opentok/OpenTok.java

@@ -369,12 +369,32 @@ public ArchiveList listArchives(int offset, int count) throws OpenTokException {
         }
     }
 
+    /**
+     * Starts archiving an OpenTok session. This version of the <code>startArchive()</code> method
+     * lets you disable audio or video recording.
+     *
+     * <p>
+     * Clients must be actively connected to the OpenTok session for you to successfully start recording an archive.
+     * <p>
+     * You can only record one archive at a time for a given session. You can only record archives
+     * of sessions that use the OpenTok Media Router (sessions with the
+     * <a href="http://tokbox.com/opentok/tutorials/create-session/#media-mode">media mode</a>
+     * set to routed); you cannot archive sessions with the media mode set to relayed.
+     *
+     * @param sessionId The session ID of the OpenTok session to archive.
+     *
+     * @param name The name of the archive. You can use this name to identify the archive. It is a property
+     * of the Archive object, and it is a property of archive-related events in the OpenTok client libraries.
+     *
+     * @return The Archive object. This object includes properties defining the archive, including the archive ID.
+     */
     public Archive startArchive(String sessionId, String name) throws OpenTokException {
         return startArchive(sessionId, name, true, true);
     }
 
     /**
-     * Starts archiving an OpenTok 2.0 session.
+     * Starts archiving an OpenTok session. This version of the <code>startArchive()</code> method
+     * lets you disable audio or video recording.
      *
      * <p>
      * Clients must be actively connected to the OpenTok session for you to successfully start recording an archive.
@@ -385,8 +405,19 @@ public Archive startArchive(String sessionId, String name) throws OpenTokExcepti
      * set to routed); you cannot archive sessions with the media mode set to relayed.
      *
      * @param sessionId The session ID of the OpenTok session to archive.
+     *
      * @param name The name of the archive. You can use this name to identify the archive. It is a property
-     * of the Archive object, and it is a property of archive-related events in the OpenTok JavaScript SDK.
+     * of the Archive object, and it is a property of archive-related events in the OpenTok client libraries.
+     *
+     * @param hasVideo Whether the archive will include an audio track (<code>true</code>) or not
+     * <code>false</code>). The default value is <code>true</code> (an audio track is included). If you set
+     * both  <code>hasAudio</code> and <code>hasAudio</code> to <code>false</code>, the call to the
+     * <code>startArchive()</code> method results in an error.
+     *
+     * @param hasAudio Whether the archive will include a video track (<code>true</code>) or not
+     * <code>false</code>). The default value is <code>true</code> (a video track is included). If you set
+     * both  <code>hasAudio</code> and <code>hasAudio</code> to <code>false</code>, the call to the
+     * <code>startArchive()</code> method results in an error.
      *
      * @return The Archive object. This object includes properties defining the archive, including the archive ID.
      */
@@ -410,7 +441,7 @@ public Archive startArchive(String sessionId, String name, boolean hasVideo, boo
      * session being archived.
      *
      * @param archiveId The archive ID of the archive you want to stop recording.
-     * @return The Archive object corresponding to the archive being STOPPED.
+     * @return The Archive object corresponding to the archive being stopped.
      */
     public Archive stopArchive(String archiveId) throws OpenTokException {