Allow directories for GN data lists.

tools/gn/variables.cc

 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #include "tools/gn/variables.h"
 
 namespace variables {
 
 // Built-in variables ----------------------------------------------------------
 
@@ skipping 491 matching lines @@
     "    configs -= \"//build:no_rtti\"  # Don't use the default RTTI config.\n"
     "    configs += \":mysettings\"      # Add some of our own settings.\n"
     "  }\n";
 
 const char kData[] = "data";
 const char kData_HelpShort[] =
     "data: [file list] Runtime data file dependencies.";
 const char kData_Help[] =
     "data: Runtime data file dependencies.\n"
     "\n"
-    "  Lists files required to run the given target. These are typically\n"
-    "  data files. The paths are interpreted as being relative to the current\n"
-    "  build file. Since these are runtime dependencies, they do not affect\n"
-    "  which targets are built or when. To declare input files to a script,\n"
-    "  use \"inputs\".\n"
+    "  Lists files or directories required to run the given target. These are\n"
+    "  typically data files or directories of data files. The paths are\n"
+    "  interpreted as being relative to the current build file. Since these\n"
+    "  are runtime dependencies, they do not affect which targets are built\n"
+    "  or when. To declare input files to a script, use \"inputs\".\n"
     "\n"
     "  Appearing in the \"data\" section does not imply any special handling\n"
     "  such as copying them to the output directory. This is just used for\n"
     "  declaring runtime dependencies. Runtime dependencies can be queried\n"
     "  using the \"runtime_deps\" category of \"gn desc\" or written during\n"
     "  build generation via \"--runtime-deps-list-file\".\n"
     "\n"
     "  GN doesn't require data files to exist at build-time. So actions that\n"
     "  produce files that are in turn runtime dependencies can list those\n"
     "  generated files both in the \"outputs\" list as well as the \"data\"\n"
     "  list.\n"
     "\n"
+    "  By convention, directories are be listed with a trailing slash:\n"
+    "    data = [ \"test/data/\" ]\n"
+    "  However, no verification is done on these so GN doesn't enforce this.\n"
+    "  The paths are just rebased and passed along when requested.\n"
+    "\n"
     "  See \"gn help runtime_deps\" for how these are used.\n";
 
 const char kDataDeps[] = "data_deps";
 const char kDataDeps_HelpShort[] =
     "data_deps: [label list] Non-linked dependencies.";
 const char kDataDeps_Help[] =
     "data_deps: Non-linked dependencies.\n"
     "\n"
     "  A list of target labels.\n"
     "\n"
@@ skipping 584 matching lines @@
     INSERT_VARIABLE(Sources)
     INSERT_VARIABLE(Testonly)
     INSERT_VARIABLE(Visibility)
   }
   return info_map;
 }
 
 #undef INSERT_VARIABLE
 
 }  // namespace variables