Update the timeout docs

Author: zsxwing

rxjava-core/src/main/java/rx/Observable.java

@@ -7744,9 +7744,9 @@ public final Observable<TimeInterval<T>> timeInterval(Scheduler scheduler) {
     }
 
     /**
-     * Returns an Observable that completes if either the first item emitted by the source
-     * Observable or any subsequent item don't arrive within time windows defined by other
-     * Observables.
+     * Returns an Observable that mirrors the source Observable, but emits a TimeoutException
+     * if either the first item emitted by the source Observable or any subsequent item
+     * don't arrive within time windows defined by other Observables.
      * <p>
      * <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/timeout5.png">
      * 
@@ -7799,16 +7799,16 @@ public final <U, V> Observable<T> timeout(Func0<? extends Observable<U>> firstTi
     }
 
     /**
-     * Returns an Observable that mirrors the source Observable, but completes if an item emitted by
+     * Returns an Observable that mirrors the source Observable, but emits a TimeoutException if an item emitted by
      * the source Observable doesn't arrive within a window of time after the emission of the
      * previous item, where that period of time is measured by an Observable that is a function
      * of the previous item.
      * <p>
      * <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/timeout3.png">
      * <p>
-     * The arrival of the first source item is never timed out.
+     * Note: The arrival of the first source item is never timed out.
      * 
-     * @param <U>
+     * @param <V>
      *            the timeout value type (ignored)
      * @param timeoutSelector
      *            a function that returns an observable for each item emitted by the source
@@ -7831,7 +7831,7 @@ public final <V> Observable<T> timeout(Func1<? super T, ? extends Observable<V>>
      * <p>
      * The arrival of the first source item is never timed out.
      * 
-     * @param <U>
+     * @param <V>
      *            the timeout value type (ignored)
      * @param timeoutSelector
      *            a function that returns an observable for each item emitted by the source

rxjava-core/src/main/java/rx/operators/OperatorTimeoutWithSelector.java

@@ -1,3 +1,18 @@
+/**
+ * Copyright 2014 Netflix, Inc.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * 
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 package rx.operators;
 
 import rx.Observable;
@@ -8,6 +23,12 @@
 import rx.util.functions.Func0;
 import rx.util.functions.Func1;
 
+/**
+ * Returns an Observable that mirrors the source Observable. If either the first
+ * item emitted by the source Observable or any subsequent item don't arrive
+ * within time windows defined by provided Observables, switch to the
+ * <code>other</code> Observable if provided, or emit a TimeoutException .
+ */
 public class OperatorTimeoutWithSelector<T, U, V> extends
         OperatorTimeoutBase<T> {