gn desc: printing public_deps without --all and --tree

tools/gn/command_desc.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 <algorithm>
 #include <set>
 #include <sstream>
 
@@ skipping 296 matching lines @@
 
   all_dependent_configs
   allow_circular_includes_from
   arflags [--blame]
   args
   cflags [--blame]
   cflags_cc [--blame]
   cflags_cxx [--blame]
   check_includes
   configs [--tree] (see below)
+  data_deps (see below)
   defines [--blame]
   depfile
   deps [--all] [--tree] (see below)
   include_dirs [--blame]
   inputs
   ldflags [--blame]
   lib_dirs
   libs
+  linked_deps (see below)
   outputs
+  public
   public_configs
-  public
+  public_deps (see below)
   script
   sources
   testonly
   visibility
 
   runtime_deps
       Compute all runtime deps for the given target. This is a computed list
       and does not correspond to any GN variable, unlike most other values
       here.
 
@@ skipping 27 matching lines @@
   Configs can have child configs. Specifying --tree will show the hierarchy.
 
 Printing outputs
 
   The "outputs" section will list all outputs that apply, including the outputs
   computed from the tool definition (eg for "executable", "static_library", ...
   targets).
 
 Printing deps
 
-  Deps will include all public, private, and data deps (TODO this could be
-  clarified and enhanced) sorted in order applying. The following may be used:
+  There are 4 different fields which contain information about deps:
+
+    - deps: if the command is invoked without --tree and --all it just

[brettw, 2017/06/08 18:02:52]

The formatting I would use in other places to avoid ambiguity with hyphen being
for command line flags is a separate line for the heading, and then a 4-space
indent with complete sentences:

    deps
        If the command is invoked...
    public_deps
        If the...

[mbonadei1, 2017/06/09 11:16:36]

Done.

+        includes private deps (see below for --tree and --all);
+    - public_deps: if the command is invoked without --tree and --all it
+        includes public deps. If the command is invoked with --tree or --all
+        this field is not printed;
+    - data_deps: includes data deps;
+    - linked_deps: includes public and private deps sorted in order applying.
+
+  The following may be used:
 
   --all
       Collects all recursive dependencies and prints a sorted flat list. Also
       usable with --tree (see below).
 )"
 
     TARGET_PRINTING_MODE_COMMAND_LINE_HELP
 "\n"
     TARGET_TESTONLY_FILTER_COMMAND_LINE_HELP
 
@@ skipping 113 matching lines @@
 
       if (!PrintConfig(config, what_to_print, !multiple_outputs))
         return 1;
     }
   }
 
   return 0;
 }
 
 }  // namespace commands