Changed java docs to not suggesting if operation is hot

Author: Your Name

src/main/java/rx/Observable.java

@@ -3285,9 +3285,9 @@ public final <TClosing> Observable<List<T>> buffer(Func0<? extends Observable<?
     /**
      * Returns an Observable that emits buffers of items it collects from the source Observable. The resulting
      * Observable emits connected, non-overlapping buffers, each containing {@code count} items. When the source
-     * Observable completes, the current buffer is emitted, and the event is propagated to all subscribed 
-     * {@link Observer}s. Note that if the source {@link Observable} issues an onError notification the event
-     * is passed on immediately without first emitting the buffer it is in the process of assembling.
+     * Observable completes, the resulting Observable emits the current buffer and propagates the notification 
+     * from the source Observable. Note that if the source Observable issues an onError notification 
+     * the event is passed on immediately without first emitting the buffer it is in the process of assembling.
      * <p>
      * <img width="640" height="320" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/buffer3.png" alt="">
      * <dl>
@@ -3308,9 +3308,9 @@ public final Observable<List<T>> buffer(int count) {
     /**
      * Returns an Observable that emits buffers of items it collects from the source Observable. The resulting
      * Observable emits buffers every {@code skip} items, each containing {@code count} items. When the source
-     * Observable completes, the current buffer is emitted, and the event is propagated to all subscribed
-     * {@link Observer}s. Note that if the source {@link Observable} issues an onError notification the event
-     * is passed on immediately without first emitting the buffer it is in the process of assembling.
+     * Observable completes, the resulting Observable emits the current buffer and propagates the notification 
+     * from the source Observable. Note that if the source Observable issues an onError notification 
+     * the event is passed on immediately without first emitting the buffer it is in the process of assembling.
      * <p>
      * <img width="640" height="320" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/buffer4.png" alt="">
      * <dl>
@@ -3336,9 +3336,9 @@ public final Observable<List<T>> buffer(int count, int skip) {
      * Returns an Observable that emits buffers of items it collects from the source Observable. The resulting
      * Observable starts a new buffer periodically, as determined by the {@code timeshift} argument. It emits
      * each buffer after a fixed timespan, specified by the {@code timespan} argument. When the source
-     * Observable completes, the current buffer is emitted, and the event is propagated to all subscribed
-     * {@link Observer}s. Note that if the source {@link Observable} issues an onError notification the event
-     * is passed on immediately without first emitting the buffer it is in the process of assembling.
+     * Observable completes, the resulting Observable emits the current buffer and propagates the notification 
+     * from the source Observable. Note that if the source Observable issues an onError notification 
+     * the event is passed on immediately without first emitting the buffer it is in the process of assembling.
      * <p>
      * <img width="640" height="320" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/buffer7.png" alt="">
      * <dl>
@@ -3367,10 +3367,10 @@ public final Observable<List<T>> buffer(long timespan, long timeshift, TimeUnit
      * Returns an Observable that emits buffers of items it collects from the source Observable. The resulting
      * Observable starts a new buffer periodically, as determined by the {@code timeshift} argument, and on the
      * specified {@code scheduler}. It emits each buffer after a fixed timespan, specified by the
-     * {@code timespan} argument. When the source Observable completes completes, the current buffer is emitted,
-     * and the event is propagated to all subscribed  {@link Observer}s. Note that if the source {@link Observable}
-     * issues an onError notification the event is passed on immediately without first emitting the buffer it is
-     * in the process of assembling.
+     * {@code timespan} argument. When the source Observable completes, the resulting Observable emits the current 
+     * buffer and propagates the notification  from the source Observable. Note that if the source 
+     * Observable issues an onError notification the event is passed on immediately without first emitting 
+     * the buffer it is in the process of assembling.
      * <p>
      * <img width="640" height="320" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/buffer7.s.png" alt="">
      * <dl>
@@ -3400,10 +3400,10 @@ public final Observable<List<T>> buffer(long timespan, long timeshift, TimeUnit
     /**
      * Returns an Observable that emits buffers of items it collects from the source Observable. The resulting
      * Observable emits connected, non-overlapping buffers, each of a fixed duration specified by the
-     * {@code timespan} argument. When the source Observable completes, the current buffer is emitted,
-     * and the event is propagated to all subscribed  {@link Observer}s. Note that if the source {@link Observable}
-     * issues an onError notification the event is passed on immediately without first emitting the buffer it is
-     * in the process of assembling.
+     * {@code timespan} argument. When the source Observable completes, the resulting Observable emits the current 
+     * buffer and propagates the notification  from the source Observable. Note that if the source 
+     * Observable issues an onError notification the event is passed on immediately without first emitting 
+     * the buffer it is in the process of assembling.
      * <p>
      * <img width="640" height="320" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/buffer5.png" alt="">
      * <dl>
@@ -3431,9 +3431,9 @@ public final Observable<List<T>> buffer(long timespan, TimeUnit unit) {
      * Returns an Observable that emits buffers of items it collects from the source Observable. The resulting
      * Observable emits connected, non-overlapping buffers, each of a fixed duration specified by the
      * {@code timespan} argument or a maximum size specified by the {@code count} argument (whichever is reached
-     * first). When the source Observable completes, the current buffer is emitted, and the event is propagated
-     * to all subscribed  {@link Observer}s. Note that if the source {@link Observable} issues an onError
-     * notification the event is passed on immediately without first emitting the buffer it is in the process
+     * first). When the source Observable completes, the resulting Observable emits the current  buffer and propagates 
+     * the notification  from the source Observable. Note that if the source Observable issues an onError 
+     * notification the event is passed on immediately without first emitting the buffer it is in the process 
      * of assembling.
      * <p>
      * <img width="640" height="320" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/buffer6.png" alt="">
@@ -3465,9 +3465,9 @@ public final Observable<List<T>> buffer(long timespan, TimeUnit unit, int count)
      * Returns an Observable that emits buffers of items it collects from the source Observable. The resulting
      * Observable emits connected, non-overlapping buffers, each of a fixed duration specified by the
      * {@code timespan} argument as measured on the specified {@code scheduler}, or a maximum size specified by
-     * the {@code count} argument (whichever is reached first). When the source Observable completes, the
-     * current buffer is emitted, and the event is propagated to all subscribed  {@link Observer}s. Note that
-     * if the source {@link Observable} issues an onError notification the event is passed on immediately
+     * the {@code count} argument (whichever is reached first). When the source Observable completes, the resulting 
+     * Observable emits the current buffer and propagates the notification from the source Observable. 
+     * Note that if the source Observable issues an onError notification the event is passed on immediately 
      * without first emitting the buffer it is in the process of assembling.
      * <p>
      * <img width="640" height="320" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/buffer6.s.png" alt="">
@@ -3501,8 +3501,8 @@ public final Observable<List<T>> buffer(long timespan, TimeUnit unit, int count,
      * Returns an Observable that emits buffers of items it collects from the source Observable. The resulting
      * Observable emits connected, non-overlapping buffers, each of a fixed duration specified by the
      * {@code timespan} argument and on the specified {@code scheduler}. When the source Observable completes, 
-     * the current buffer is emitted, and the event is propagated to all subscribed  {@link Observer}s. Note
-     * that if the source {@link Observable} issues an onError notification the event is passed on immediately
+     * the resulting Observable emits the current buffer and propagates the notification from the source Observable. 
+     * Note that if the source Observable issues an onError notification the event is passed on immediately 
      * without first emitting the buffer it is in the process of assembling.
      * <p>
      * <img width="640" height="320" src="https://raw.github.com/wiki/ReactiveX/RxJava/images/rx-operators/buffer5.s.png" alt="">

src/main/java/rx/internal/operators/OperatorBufferWithSize.java

@@ -31,7 +31,7 @@
  * values from the specified {@link Observable} source and stores them in all active chunks until the buffer
  * contains a specified number of elements. The buffer is then emitted. Chunks are created after a certain
  * amount of values have been received. When the source {@link Observable} completes, the current buffer is
- * emitted, and the event is propagated to all subscribed {@link Observer}s. Note that if the source
+ * emitted, and the event is propagated to all subscribed {@link Subscriber}s. Note that if the source
  * {@link Observable} issues an onError notification the event is passed on immediately without first emitting
  * the buffer it is in the process of assembling.
  * <p>

src/main/java/rx/internal/operators/OperatorBufferWithTime.java

@@ -35,7 +35,7 @@
  * is emitted and replaced with a new buffer. How often this is done depends on the specified timespan.
  * The creation of chunks is also periodical. How often this is done depends on the specified timeshift.
  * When the source {@link Observable} completes, the current buffer is emitted, and the event is propagated
- * to all subscribed {@link Observer}s. Note that if the source {@link Observable} issues an onError
+ * to all subscribed {@link Subscriber}s. Note that if the source {@link Observable} issues an onError
  * notification the event is passed on immediately without first emitting the buffer it is in the process
  * of assembling.
  * <p>