X-Git-Url: https://adrianiainlam.tk/git/?a=blobdiff_plain;f=closure-todo.txt;h=5c614950c2e9d58ddbcf00c9c8db2f44be753ac6;hb=1dc23fac4c126b2b3742801b2d82137044498ebf;hp=368946028cd39c51dd2ba3efa8227dd584d9227b;hpb=b2867ee146232090701daafb9ec6b65a99841d7e;p=dygraphs.git

diff --git a/closure-todo.txt b/closure-todo.txt
index 3689460..5c61495 100644
--- a/closure-todo.txt
+++ b/closure-todo.txt
@@ -1,22 +1,37 @@
+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-gviz.js
 - dygraph-interaction-model.js
 - dygraph-layout.js
-- dygraph-options.js
+x 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/base.js
 - plugins/chart-labels.js
 - plugins/grid.js
-- plugins/install.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=dygraph-options.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.