docs($log): add note about blackboxing

davesidious · Narretz · commit 1b8eb231c937 · 2017-06-30T12:04:21.000+02:00
Add browser-agnostic hint about blackboxing and the benefits it brings developers when using $log. Closes #15592
diff --git a/src/ng/log.js b/src/ng/log.js
@@ -11,6 +11,14 @@
  *
  * The main purpose of this service is to simplify debugging and troubleshooting.
  *
+ * To reveal the location of the calls to `$log` in the JavaScript console,
+ * you can "blackbox" the AngularJS source in your browser:
+ *
+ * [Mozilla description of blackboxing](https://developer.mozilla.org/en-US/docs/Tools/Debugger/How_to/Black_box_a_source).
+ * [Chrome description of blackboxing](https://developer.chrome.com/devtools/docs/blackboxing).
+ *
+ * Note: Not all browsers support blackboxing.
+ *
  * The default is to log `debug` messages. You can use
  * {@link ng.$logProvider ng.$logProvider#debugEnabled} to change this.
  *

Original file line number	Diff line number	Diff line change
`@@ -11,6 +11,14 @@`
`11`	`11`	`*`
`12`	`12`	`* The main purpose of this service is to simplify debugging and troubleshooting.`
`13`	`13`	`*`
	`14`	+ * To reveal the location of the calls to `$log` in the JavaScript console,
	`15`	`+ * you can "blackbox" the AngularJS source in your browser:`
	`16`	`+ *`
	`17`	`+ * [Mozilla description of blackboxing](https://developer.mozilla.org/en-US/docs/Tools/Debugger/How_to/Black_box_a_source).`
	`18`	`+ * [Chrome description of blackboxing](https://developer.chrome.com/devtools/docs/blackboxing).`
	`19`	`+ *`
	`20`	`+ * Note: Not all browsers support blackboxing.`
	`21`	`+ *`
`14`	`22`	* The default is to log `debug` messages. You can use
`15`	`23`	`* {@link ng.$logProvider ng.$logProvider#debugEnabled} to change this.`
`16`	`24`	`*`