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 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