[dygraphs.git] / closure-todo.txt

Many of the functions and methods in the dygraphs source have some form of
Closure annotations on them ("@param", "@return", "@private", etc.).

These provide some documentation value, but they were largely written by
developers who had never used the Closure Compiler and so the syntax is
often not quite correct.

This file tracks which files have been fully "closurized", i.e. compile
under the Closure Compiler without any errors or warnings.

Core:
- dygraph-canvas.js
- dygraph-interaction-model.js
- dygraph-layout.js
- dygraph-options.js
- dygraph-range-selector.js
- dygraph.js
x dygraph-gviz.js
x dygraph-tickers.js
x dygraph-options-reference.js
x dygraph-utils.js
x dashed-canvas.js
- dygraph-plugin-base.js
- dygraph-plugin-install.js

Plugins:
- plugins/annotations.js
- plugins/axes.js
- plugins/chart-labels.js
- plugins/grid.js
- plugins/legend.js

Here's a command that can be used to build dygraphs using the closure
compiler:
java -jar ../../closure-compiler-read-only/build/compiler.jar --js=dygraph-utils.js --js=dashed-canvas.js --js=dygraph-options-reference.js --js=dygraph-tickers.js --js=dygraph-gviz.js --js_output_file=/tmp/out.js --compilation_level ADVANCED_OPTIMIZATIONS --warning_level VERBOSE --externs dygraph-externs.js

As each file is closurized, it can be added as a "--js" parameter.
Commit	Line	Data
	1	Many of the functions and methods in the dygraphs source have some form of
	2	Closure annotations on them ("@param", "@return", "@private", etc.).
	3
	4	These provide some documentation value, but they were largely written by
	5	developers who had never used the Closure Compiler and so the syntax is
	6	often not quite correct.
	7
	8	This file tracks which files have been fully "closurized", i.e. compile
	9	under the Closure Compiler without any errors or warnings.
	10
	11	Core:
	12	- dygraph-canvas.js
	13	- dygraph-interaction-model.js
	14	- dygraph-layout.js
	15	- dygraph-options.js
	16	- dygraph-range-selector.js
	17	- dygraph.js
	18	x dygraph-gviz.js
	19	x dygraph-tickers.js
	20	x dygraph-options-reference.js
	21	x dygraph-utils.js
	22	x dashed-canvas.js
	23	- dygraph-plugin-base.js
	24	- dygraph-plugin-install.js
	25
	26	Plugins:
	27	- plugins/annotations.js
	28	- plugins/axes.js
	29	- plugins/chart-labels.js
	30	- plugins/grid.js
	31	- plugins/legend.js
	32
	33	Here's a command that can be used to build dygraphs using the closure
	34	compiler:
	35	java -jar ../../closure-compiler-read-only/build/compiler.jar --js=dygraph-utils.js --js=dashed-canvas.js --js=dygraph-options-reference.js --js=dygraph-tickers.js --js=dygraph-gviz.js --js_output_file=/tmp/out.js --compilation_level ADVANCED_OPTIMIZATIONS --warning_level VERBOSE --externs dygraph-externs.js
	36
	37	As each file is closurized, it can be added as a "--js" parameter.