Generate API docs during build.

dart.gyp

Index: dart.gyp
diff --git a/dart.gyp b/dart.gyp
index 844514bc5583edca4afe561cb6ab65fb3e27789a..832b231024f6990e0855d1e97c0aef28bd555a43 100644
--- a/dart.gyp
+++ b/dart.gyp
@@ -4,7 +4,7 @@
 
 {
   'variables': {
-    # These variables are used in the creation of the .vcproj file on 
+    # These variables are used in the creation of the .vcproj file on
     # Windows.
     'cygwin_dir': 'third_party/cygwin',
   },
@@ -105,6 +105,29 @@
           ],
         },
       ],
+    },
+    {
+      'target_name': 'api_docs',

[ahe, 2012/03/16 08:07:40]

I think this target belongs in its own GYP file, for example,
utils/apidoc/apidoc.gyp. See the 'frog' target above.

[Bob Nystrom, 2012/03/28 20:19:36]

Done.

+      'type': 'none',
+      'dependencies': [
+        'frog', 'runtime',
+      ],
+      'actions': [
+        {
+          'action_name': 'run_apidoc',
+          'inputs': [
+            'utils/apidoc',

[ahe, 2012/03/16 08:07:40]

No directory dependencies, please. Consider:

* If you change a file in a subdirectory, Make, Xcode, and Visual Studio
correctly see that the directory has changed (I'm pretty sure that this doesn't
work based on quick experiments with directory time stamps on my Mac).

* Xcode and Visual Studio correctly list the files that belong to this target.

* if you change nothing, but run "svn update" and .svn is touched, this target
won't be rebuilt.

Also, you need to list the library dependencies. Fortunately, the VM team is
already maintaining those. Try running: "find corelib runtime -name \*.gypi"

[Bob Nystrom, 2012/03/28 20:19:36]

Done, but I'm having some problems. I wrote a "list files" script similar to
what frog uses. It should work in theory, but it doesn't seem to. When I change
an input file, GYP doesn't seem to notice that the API docs are out of date and
rebuild them. I have to manually delete the output directory instead.

Any idea what's going on here?

+            'lib/dartdoc',
+          ],
+          'outputs': [
+            '<(PRODUCT_DIR)/api_docs',
+          ],
+          'action': [
+            'utils/apidoc/apidoc',

[ahe, 2012/03/16 08:07:40]

This needs to be installed in PRODUCT_DIR as a real program. Otherwise, you
cannot reliably find the right version of the dart VM.

I once sent you an example of how to do this in pure dart:
https://chromiumcodereview.appspot.com/9454026/

An alternative is to use something similar to the generate_frog action in
frog/dart-frog.gyp.

[Bob Nystrom, 2012/03/28 20:19:36]

Done. Just invoking a dart script now.

+            '--out=<(PRODUCT_DIR)/api_docs'
+          ],
+        },
+      ],
     }
   ],
 }