Generate API docs during build.

dart.gyp

 # Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
 # for details. All rights reserved. Use of this source code is governed by a
 # BSD-style license that can be found in the LICENSE file.
 
 {
   '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',
   },
   'targets': [
     {
       'target_name': 'compiler',
       'type': 'none',
       'dependencies': [
         'compiler/dart-compiler.gyp:dartc',
       ],
@@ skipping 80 matching lines @@
           'outputs': [
             '<(PRODUCT_DIR)/upload_sdk',
           ],
           'action': [
             'python',
             'tools/upload_sdk.py',
             '<(PRODUCT_DIR)/dart-sdk'
           ],
         },
       ],
+    },
+    {
+      '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'
+          ],
+        },
+      ],
     }
   ],
 }