From 8348549147dfe44baba658f8adfc6a922e6ac944 Mon Sep 17 00:00:00 2001
From: Jay Phelps <hello@jayphelps.com>
Date: Thu, 26 Jan 2017 17:55:36 -0800
Subject: [PATCH] docs(catch): minor changes to indention and wording

---
 src/operator/catch.ts | 60 ++++++++++++++++++++++++-------------------
 1 file changed, 33 insertions(+), 27 deletions(-)

diff --git a/src/operator/catch.ts b/src/operator/catch.ts
index 7f6ac169e2..ab7aeed5d3 100644
--- a/src/operator/catch.ts
+++ b/src/operator/catch.ts
@@ -8,43 +8,49 @@ import { subscribeToResult } from '../util/subscribeToResult';
 /**
  * Catches errors on the observable to be handled by returning a new observable or throwing an error.
  *
- * @example <caption>Returns a different Observable in case of error</caption>
+ * @example <caption>Continues with a different Observable when there's an error</caption>
  * 
- * let primary$ = Observable.of(1, 2, 3, 4, 5);
- * let secondary$ = Observable.of('I', 'II', 'III', 'IV', 'V');
- * 
- * primary$
- *     .map(n => { 
- * 	if (n == 4) 
- * 	    throw 'four!'; 
- * 	return n; 
- *     })
- *     .catch(err => secondary$)
- * 	.subscribe(x => console.log(x)); // -> 1, 2, 3, I, II, III, IV, V
+ * Observable.of(1, 2, 3, 4, 5)
+ *   .map(n => { 
+ * 	   if (n == 4) {
+ * 	     throw 'four!';
+ *     }
+ *	   return n; 
+ *   })
+ *   .catch(err => Observable.of('I', 'II', 'III', 'IV', 'V'))
+ *   .subscribe(x => console.log(x)); // -> 1, 2, 3, I, II, III, IV, V
  *
- * @example <caption>"Tries" the Observable again in case of error</caption>
+ * @example <caption>Retries the caught source Observable again in case of error, similar to retry() operator</caption>
  *
  * Observable.of(1, 2, 3, 4, 5)
- *     .map(n => { 
- * 	  if (n === 4) 
- * 	    throw 'four!'; 
- * 	  return n; 
- *     })
- *     .catch((err, caught) => caught)
- *     .take(30)
- *     .subscribe(x => console.log(x)); // 1, 2, 3, 1, 2, 3, ...
+ *   .map(n => { 
+ * 	   if (n === 4) {
+ * 	     throw 'four!'; 
+ *     }
+ * 	   return n; 
+ *   })
+ *   .catch((err, caught) => caught)
+ *   .take(30)
+ *   .subscribe(x => console.log(x));
+ *   // 1, 2, 3, 1, 2, 3, ...
  * 
  * @example <caption>Throws a new error when the source Observable throws an error</caption>
  * 
  * Observable.of(1, 2, 3, 4, 5)
  *   .map(n => { 
- *     if (n == 4) 
- *       throw 'four!'; 
- *       return n; 
+ *     if (n == 4) {
+ *       throw 'four!';
+ *     }
+ *     return n; 
+ *   })
+ *   .catch(err => {
+ *     throw 'error in source. Details: ' + err;
  *   })
- *   .catch(err => { throw 'error in source. Details: ' + err; })
- *   .subscribe(x => console.log(x),
- *              err => console.log(err)); -> 1, 2, 3, error in source. Details: four!
+ *   .subscribe(
+ *     x => console.log(x),
+ *     err => console.log(err)
+ *   );
+ *   // 1, 2, 3, error in source. Details: four!
  * 
  * @param {function} selector a function that takes as arguments `err`, which is the error, and `caught`, which
  *  is the source observable, in case you'd like to "retry" that observable by returning it again. Whatever observable