Add ninja console pool support to GN

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 556 matching lines @@
     "    cflags = [ ... ]\n"
     "  }\n"
     "  config(\"default_optimization\") {\n"
     "    if (optimize_everything) {\n"
     "      configs = [ \":super_optimization\" ]\n"
     "    } else {\n"
     "      configs = [ \":no_optimization\" ]\n"
     "    }\n"
     "  }\n";
 
+const char kConsole[] = "console";
+const char kConsole_HelpShort[] =
+    "console [boolean]: Run this action in the console pool.";
+const char kConsole_Help[] =
+    "console: Run this action in the console pool.\n"
+    "\n"
+    "  Boolean. Defaults to false.\n"
+    "\n"
+    "  Actions marked \"console = true\" will be run in the built-in ninja\n"
+    "  \"console\" pool. They will have access to real stdin and stdout, and\n"
+    "  output will not be buffered by ninja. This can be useful for\n"
+    "  long-running actions with progress logs, or actions that require user \n"
+    "  input.\n"
+    "\n"
+    "  Only one console pool target can run at any one time in Ninja. Refer\n"
+    "  to the Ninja documentation on the console pool for more info.\n"
+    "\n"
+    "Example\n"
+    "\n"
+    "  action(\"long_action_with_progress_logs\") {\n"
+    "    console = true\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 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"
@@ skipping 655 matching lines @@
     INSERT_VARIABLE(AllowCircularIncludesFrom)
     INSERT_VARIABLE(Args)
     INSERT_VARIABLE(Cflags)
     INSERT_VARIABLE(CflagsC)
     INSERT_VARIABLE(CflagsCC)
     INSERT_VARIABLE(CflagsObjC)
     INSERT_VARIABLE(CflagsObjCC)
     INSERT_VARIABLE(CheckIncludes)
     INSERT_VARIABLE(CompleteStaticLib)
     INSERT_VARIABLE(Configs)
+    INSERT_VARIABLE(Console)
     INSERT_VARIABLE(Data)
     INSERT_VARIABLE(DataDeps)
     INSERT_VARIABLE(Defines)
     INSERT_VARIABLE(Depfile)
     INSERT_VARIABLE(Deps)
     INSERT_VARIABLE(ForwardDependentConfigsFrom)
     INSERT_VARIABLE(IncludeDirs)
     INSERT_VARIABLE(Inputs)
     INSERT_VARIABLE(Ldflags)
     INSERT_VARIABLE(Libs)
@@ skipping 10 matching lines @@
     INSERT_VARIABLE(Sources)
     INSERT_VARIABLE(Testonly)
     INSERT_VARIABLE(Visibility)
   }
   return info_map;
 }
 
 #undef INSERT_VARIABLE
 
 }  // namespace variables