Add support for customizing GN's args text.

tools/gn/command_args.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 <stddef.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
 
 #include <map>
@@ skipping 225 matching lines @@
     if (!setup.DoSetup(build_dir, true))
       return 1;
 
     // Ensure the file exists. Need to normalize path separators since on
     // Windows they can come out as forward slashes here, and that confuses some
     // of the commands.
     base::FilePath arg_file =
         setup.build_settings().GetFullPath(setup.GetBuildArgFile())
         .NormalizePathSeparators();
     if (!base::PathExists(arg_file)) {
-      std::string argfile_default_contents =
-          "# Build arguments go here. Examples:\n"
-          "#   is_component_build = true\n"
-          "#   is_debug = false\n"
-          "# See \"gn args <out_dir> --list\" for available build "
-          "arguments.\n";
+      BuildSettings build_settings = setup.build_settings();
+      base::FilePath arg_file_template_path =
+        build_settings.GetFullPath(build_settings.arg_file_template_path())

[brettw, 2016/11/22 16:14:32]

Indent more.

[Dirk Pranke, 2016/11/22 18:41:52]

Done.

+        .NormalizePathSeparators();
+
+      std::string argfile_default_contents;
+      if (!build_settings.arg_file_template_path().is_null()) {
+        base::FilePath arg_file_path_template_path =
+          build_settings.GetFullPath(build_settings.arg_file_template_path());

[brettw, 2016/11/22 16:14:32]

Indent mode (maybe this will have to wrap, sadly).

[Dirk Pranke, 2016/11/22 18:41:52]

Reworked to be shorter.

+        if (!base::ReadFileToString(arg_file_template_path,
+                                    &argfile_default_contents)) {
+          return 1;

[Dirk Pranke, 2016/11/22 04:27:39]

Should I print an err to stdout here if this read fails?

[brettw, 2016/11/22 16:14:32]

No, but I would prefer if it fell through to the default contents.

[Dirk Pranke, 2016/11/22 18:41:52]

Done. I'm not sure if I'm wild about that, but it's probably also not usually
going to happen.

+        }
+      } else {
+        argfile_default_contents =
+            "# Build arguments go here. Examples:\n"
+            "#   is_component_build = true\n"
+            "#   is_debug = false\n"

[brettw, 2016/11/22 16:14:32]

Can you remove the examples in this case?

[Dirk Pranke, 2016/11/22 18:41:52]

Done.

+            "# See \"gn args <out_dir> --list\" for available build "
+            "arguments.\n";
+      }
 #if defined(OS_WIN)
       // Use Windows lineendings for this file since it will often open in
       // Notepad which can't handle Unix ones.
       base::ReplaceSubstringsAfterOffset(
           &argfile_default_contents, 0, "\n", "\r\n");
 #endif
       base::CreateDirectory(arg_file.DirName());
       base::WriteFile(arg_file, argfile_default_contents.c_str(),
                       static_cast<int>(argfile_default_contents.size()));
     }
@@ skipping 81 matching lines @@
         "Or see \"gn help args\" for more variants.").PrintToStdout();
     return 1;
   }
 
   if (base::CommandLine::ForCurrentProcess()->HasSwitch(kSwitchList))
     return ListArgs(args[0]);
   return EditArgsFile(args[0]);
 }
 
 }  // namespace commands