Documentation for rewrite_polyfills in the API is missing

[mattwomple]

I noticed the output from the command-line closure compiler included polyfills (recognizable by inclusion of $jscomp object at the beginning of the code), but the API service and the demo compiler do not include polyfills by default. I stumbled around the internet for a while before I finally found an answer on stack overflow that pointed me to the rewrite_polyfills parameter. It would be great if rewrite_polyfills could be documented at https://developers.google.com/closure/compiler/docs/api-ref and the default noted.

[ChadKillingsworth]

We keep all the flags documented here now: https://github.com/google/closure-compiler/wiki/Flags-and-Options

But it would be nice if the developers site could be updated to point there.

[concavelenz]

We should also rename the option, as it doesn't rewrite polyfills it simply includes them.

[Daijobou]

https://github.com/google/closure-compiler/wiki/Flags-and-Options#library-and-framework-specific
rewrite_polyfills has a poor explanation there of what it does. At least for me.

[lauraharker]

https://github.com/google/closure-compiler/wiki/Polyfills has some more details on --rewrite_polyfills. Also agree that ""Rewrite ES6 library calls" is not a good description of that that flag does.

I'll send out a change making

closure-compiler/src/com/google/javascript/jscomp/CommandLineRunner.java

Line 837 in 63cd2c1

usage = "Rewrite ES6 library calls to use polyfills provided by the compiler's runtime.")

point there (https://github.com/google/closure-compiler/wiki/Flags-and-Options is generated from CommandLineRunner.java)

[lauraharker]

https://developers.google.com/closure/compiler/docs/api-ref now includes rewrite_polyfills so marking as fixed.