Index: tools/gn/variables.cc |
diff --git a/tools/gn/variables.cc b/tools/gn/variables.cc |
index aa4de3650fa2cd621b0963a873191c2162e12c05..7898273fee24085d7085fb9033d551e2df2cec9c 100644 |
--- a/tools/gn/variables.cc |
+++ b/tools/gn/variables.cc |
@@ -722,14 +722,31 @@ const char kDeps_Help[] = |
"\n" |
" A list of target labels.\n" |
"\n" |
- " Specifies private dependencies of a target. Shared and dynamic\n" |
- " libraries will be linked into the current target.\n" |
+ " Specifies private dependencies of a target. Private dependencies are\n" |
+ " propagated up the dependency tree and linked to dependant targets, but\n" |
+ " do not grant the ability to include headers from the dependency.\n" |
+ " Public configs are not forwarded.\n" |
"\n" |
- " These dependencies are private in that it does not grant dependent\n" |
- " targets the ability to include headers from the dependency, and direct\n" |
- " dependent configs are not forwarded.\n" |
+ "Details of dependency propagation\n" |
"\n" |
- " See also \"public_deps\" and \"data_deps\".\n"; |
+ " Source sets, shared libraries, and non-complete static libraries\n" |
+ " will be propagated up the dependency tree across groups, non-complete\n" |
+ " static libraries and source sets.\n" |
+ "\n" |
+ " Executables, shared libraries, and complete static libraries will\n" |
+ " link all propagated targets and stop propagation. Actions and copy\n" |
+ " steps also stop propagation, allowing them to take a library as an\n" |
+ " input but not force dependants to link to it.\n" |
+ "\n" |
+ " Propagation of all_dependent_configs and public_configs happens\n" |
+ " independently of target type. all_dependent_configs are always\n" |
+ " propagated across all types of targets, and public_configs\n" |
+ " are always propagated across public deps of all types of targets.\n" |
+ "\n" |
+ " Data dependencies are propagated differently. See\n" |
+ " \"gn help data_deps\" and \"gn help runtime_deps\".\n" |
+ "\n" |
+ " See also \"public_deps\".\n"; |
const char kIncludeDirs[] = "include_dirs"; |
const char kIncludeDirs_HelpShort[] = |
@@ -1122,9 +1139,9 @@ const char kPublicDeps_HelpShort[] = |
const char kPublicDeps_Help[] = |
"public_deps: Declare public dependencies.\n" |
"\n" |
- " Public dependencies are like private dependencies (\"deps\") but\n" |
- " additionally express that the current target exposes the listed deps\n" |
- " as part of its public API.\n" |
+ " Public dependencies are like private dependencies (see\n" |
+ " \"gn help deps\") but additionally express that the current target\n" |
+ " exposes the listed deps as part of its public API.\n" |
"\n" |
" This has several ramifications:\n" |
"\n" |