Docs edits.

Author: jeffswartz

README.md

@@ -8,9 +8,6 @@ The OpenTok Java SDK lets you generate
 applications that run on the JVM. The SDK also includes support for working with
 [OpenTok archives](http://tokbox.com/opentok/tutorials/archiving).
 
-If you are updating from a previous version of this SDK, see
-[Important changes since v2.2.0](#important-changes-since-v220).
-
 
 # Installation
 
@@ -151,19 +148,41 @@ 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`:
+You can also disable audio or video recording by calling the `hasAudio(false)` or `hasVideo(false)`
+methods of an `AchiveProperties` object you pass into the `OpenTok.startArchive(String sessionId,
+ArchiveProperties properties)` method:
 
 ```java
 import com.opentok.Archive;
+import com.opentok.ArchiveProperties;
 
 // Start an audio-only archive
-Archive archive = opentok.startArchive(sessionId, null, false, true);
+Archive archive = opentok.startArchive(sessionId, new ArchiveProperties.Builder()
+  .hasVideo(false)
+  .build()););
+
+// Store this archiveId in the database for later use
+String archiveId = archive.getId();
+```
+
+Setting the output mode to `Archive.OutputMode.INDIVIDUAL` setting causes each stream in the archive
+to be recorded to its own individual file:
+
+```java
+import com.opentok.Archive;
+import com.opentok.ArchiveProperties;
+
+Archive archive = opentok.startArchive(sessionId, new ArchiveProperties.Builder()
+  .archiveMode(Archive.OutputMode.INDIVIDUAL)
+  .build()););
 
 // Store this archiveId in the database for later use
 String archiveId = archive.getId();
 ```
 
+The `Archive.OutputMode.COMPOSED` setting (the default) causes all streams in the archive are
+recorded to a single (composed) file.
+
 You can stop the recording of a started Archive using a `com.opentok.Archive` instance's
 `stopArchive(String archiveId)` method.
 
@@ -203,6 +222,15 @@ List<Archive> archives = opentok.listArchives(0, 50);
 List<Archive> archives = opentok.listArchives(50, 50);
 ```
 
+Note that you can also create an automatically archived session, by passing `ArchiveMode.ALWAYS`
+into the `archiveMode()` method of the SessionPropertiesBuilder object you use to build the
+`sessionProperties` parameter passed into the `OpenTok->createSession()` method (see "Creating
+Sessions," above).
+
+For more information on archiving, see the
+[OpenTok archiving](https://tokbox.com/opentok/tutorials/archiving/) programming guide.
+
+
 # Samples
 
 There are two sample applications included with the SDK. To get going as fast as possible, clone the whole

src/main/java/com/opentok/Archive.java

@@ -33,6 +33,14 @@ public enum Status {
          */
         FAILED,
 
+        /**
+         * The archive is in progress and no clients are publishing streams to the session.
+         * When an archive is in progress and any client publishes a stream, the status is STARTED.
+         * When an archive is PAUSED, nothing is recorded. When a client starts publishing a stream,
+         * the recording starts (or resumes). If all clients disconnect from a session that is being
+         * archived, the status changes to PAUSED, and after 60 seconds the archive recording stops
+         * (and the status changes to STOPPED).
+         */
         PAUSED,
 
         /**
@@ -61,16 +69,17 @@ public enum Status {
     }
 
     /**
-     * Defines values returned by the {@link Archive#getOutputMode} method.
+     * Defines values used in the
+     * {@link ArchiveProperties.Builder#outputMode(com.opentok.Archive.OutputMode)} method
+     * and returned by the {@link Archive#getOutputMode} method.
      */
     public enum OutputMode {
         /**
-         * The archive file is available for download from the OpenTok cloud. You can get the URL of
-         * the download file by calling the {@link Archive#getUrl} method.
+         * All streams in the archive are recorded to a single (composed) file.
          */
         COMPOSED,
         /**
-         * The archive file has been deleted.
+         * Each stream in the archive is recorded to its own individual file.
          */
         INDIVIDUAL;
 

src/main/java/com/opentok/ArchiveProperties.java

@@ -37,9 +37,9 @@ private ArchiveProperties(Builder builder) {
     }
 
     /**
-     * Use this class to create a SessionProperties object.
+     * Use this class to create a ArchiveProperties object.
      *
-     * @see SessionProperties
+     * @see ArchiveProperties
      */
     public static class Builder {
         private String name = null;

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

@@ -372,15 +372,19 @@ 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.
+     * 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.
-     *
+     * <p>
+     * For more information on archiving, see the
+     * <a href="https://tokbox.com/opentok/tutorials/archiving/">OpenTok archiving</a>
+     * programming guide.
+     * 
      * @param sessionId The session ID of the OpenTok session to archive.
      * 
      * @param properties This ArchiveProperties object defines options for the archive.