Fix dependencies of apidoc.

dart/utils/apidoc/apidoc.gyp

Index: dart/utils/apidoc/apidoc.gyp
diff --git a/dart/utils/apidoc/apidoc.gyp b/dart/utils/apidoc/apidoc.gyp
index f3f484a45e344b4e619cb781d9e934287502f1bd..c8b6834e68f54c0005997506f69953ad6d1c9ecc 100644
--- a/dart/utils/apidoc/apidoc.gyp
+++ b/dart/utils/apidoc/apidoc.gyp
@@ -32,15 +32,12 @@
             '<(PRODUCT_DIR)/<(EXECUTABLE_PREFIX)dart<(EXECUTABLE_SUFFIX)',
             '<(PRODUCT_DIR)/dart2js.snapshot',
             '<!@(["python", "../../tools/list_files.py", "\\.(css|ico|js|json|png|sh|txt|yaml|py)$", ".", "../../sdk/lib/_internal/dartdoc"])',
-            '<!@(["python", "../../tools/list_files.py", "\\.dart$", "../../sdk/lib", "../../runtime/lib", "../../runtime/bin"])',
+            '<!@(["python", "../../tools/list_files.py", "\\.dart$", ".", "../../sdk/lib", "../../runtime/lib", "../../runtime/bin"])',

[Andrei Mouravski, 2013/04/05 19:13:50]

Please add documentation to this block or directly above 'inputs' describing
exactly what is happening.

[ahe, 2013/04/05 19:26:45]

Will do.  Let me know if this answers your questions:

The 'inputs' list records the files whose timestamps are compared to the files
listed in 'outputs'.  If a file 'outputs' doesn't exist or if a file in 'inputs'
is newer than a file in 'outputs', this action is executed.  Notice that the
dependencies listed above has nothing to do with when this action is executed. 
You must list a file in 'inputs' to make sure that it exists before the action
is executed, or to make sure this action is re-run.

We want to build the platform documentation whenever dartdoc, apidoc, or its
dependency changes.  This prevents people from accidentally breaking apidoc when
making changes to the platform libraries and or when modifying dart2js or the
VM.

In addition, we want to make sure that the platform documentation is regenerated
when the platform sources changes.

So we want this action to be re-run when a dart file changes in this directory,
or in the SDK library (we may no longer need to list the files in
../../runtime/lib and ../../runtime/bin, as most of them has moved to
../../sdk/lib).

In addition, we want to make sure the documentation is regenerated when a
resource file (CSS, PNG, etc) is updated.  This is because these files are also
copied to the output directory.

[Andrei Mouravski, 2013/04/05 22:40:18]

I think for the time being, you could just copy this verbatim in here.

I would very much like all gyp files in the gyp directory and have a README in
there about how to properly write Dart gyp files.

That is not necessary right now, but would really help.

             '../../sdk/bin/dart',
             '../../sdk/bin/dart.bat',
             '../../sdk/bin/dart2js',
             '../../sdk/bin/dart2js.bat',
           ],
-          'inputs': [
-            '<!@(["python", "../../tools/list_files.py", "\\.(css|png|dart)$", "."])',
-          ],
           'outputs': [
             '<(PRODUCT_DIR)/api_docs/index.html',
             '<(PRODUCT_DIR)/api_docs/client-static.js',