Merge pull request #829 from Netflix/docs

adding marble diagrams, see-also links to javadocs of new repeat() variants

Author: benjchristensen

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

@@ -5519,7 +5519,7 @@ public final <R> Observable<R> reduce(R initialValue, Func2<R, ? super T, R> acc
      * Returns an Observable that repeats the sequence of items emitted by the source Observable
      * indefinitely.
      * <p>
-     * <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/repeat.png">
+     * <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/repeat.o.png">
      * 
      * @return an Observable that emits the items emitted by the source Observable repeatedly and in
      *         sequence
@@ -5534,7 +5534,7 @@ public final Observable<T> repeat() {
      * Returns an Observable that repeats the sequence of items emitted by the source Observable
      * indefinitely, on a particular scheduler.
      * <p>
-     * <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/repeat.s.png">
+     * <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/repeat.os.png">
      * 
      * @param scheduler
      *            the scheduler to emit the items on
@@ -5550,12 +5550,16 @@ public final Observable<T> repeat(Scheduler scheduler) {
     /**
      * Returns an Observable that repeats the sequence of items emitted by the source
      * Observable at most count times.
+     * <p>
+     * <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/repeat.on.png">
      * 
      * @param count
      *            the number of times the source Observable items are repeated,
-     *            a count of 0 will yield an empty sequence.
+     *            a count of 0 will yield an empty sequence
      * @return an Observable that repeats the sequence of items emitted by the source
-     *         Observable at most count times.
+     *         Observable at most {@code count} times
+     * @see <a href="https://github.com/Netflix/RxJava/wiki/Creating-Observables#wiki-repeat">RxJava Wiki: repeat()</a>
+     * @see <a href="http://msdn.microsoft.com/en-us/library/hh229428.aspx">MSDN: Observable.Repeat</a>
      */
     public final Observable<T> repeat(long count) {
         if (count < 0) {
@@ -5567,14 +5571,18 @@ public final Observable<T> repeat(long count) {
     /**
      * Returns an Observable that repeats the sequence of items emitted by the source
      * Observable at most count times on a particular scheduler.
+     * <p>
+     * <img width="640" src="https://raw.github.com/wiki/Netflix/RxJava/images/rx-operators/repeat.ons.png">
      * 
      * @param count
      *            the number of times the source Observable items are repeated,
      *            a count of 0 will yield an empty sequence.
      * @param scheduler
-     *            the scheduler to emit the items on
+     *            the {@link Scheduler} to emit the items on
      * @return an Observable that repeats the sequence of items emitted by the source
-     *         Observable at most count times on a particular scheduler.
+     *         Observable at most {@code count} times on a particular Scheduler
+     * @see <a href="https://github.com/Netflix/RxJava/wiki/Creating-Observables#wiki-repeat">RxJava Wiki: repeat()</a>
+     * @see <a href="http://msdn.microsoft.com/en-us/library/hh229428.aspx">MSDN: Observable.Repeat</a>
      */
     public final Observable<T> repeat(long count, Scheduler scheduler) {
         return nest().lift(new OperatorRepeat<T>(count, scheduler));