Index: tools/gn/docs/reference.md |
diff --git a/tools/gn/docs/reference.md b/tools/gn/docs/reference.md |
index c837037434b171d38e2a1eba1982d056bd8d851c..657796abc8fb4e71a7561473fc03874a46ec3e5e 100644 |
--- a/tools/gn/docs/reference.md |
+++ b/tools/gn/docs/reference.md |
@@ -378,10 +378,6 @@ |
Shows the labels of configs applied to targets that depend on this |
one (either directly or all of them). |
- forward_dependent_configs_from |
- Shows the labels of dependencies for which dependent configs will |
- be pushed to targets depending on the current one. |
- |
script |
args |
depfile |
@@ -1036,8 +1032,7 @@ |
### **Variables on a target used to apply configs**: |
``` |
- all_dependent_configs, configs, public_configs, |
- forward_dependent_configs_from |
+ all_dependent_configs, configs, public_configs |
``` |
@@ -1230,7 +1225,7 @@ |
Flags: cflags, cflags_c, cflags_cc, cflags_objc, cflags_objcc, |
defines, include_dirs, ldflags, lib_dirs, libs, |
precompiled_header, precompiled_source |
- Deps: data_deps, deps, forward_dependent_configs_from, public_deps |
+ Deps: data_deps, deps, public_deps |
Dependent configs: all_dependent_configs, public_configs |
General: check_includes, configs, data, inputs, output_name, |
output_extension, public, sources, testonly, visibility |
@@ -1587,16 +1582,14 @@ |
specify configs that apply to their dependents. |
Depending on a group is exactly like depending directly on that |
- group's deps. Direct dependent configs will get automatically |
- forwarded through the group so you shouldn't need to use |
- "forward_dependent_configs_from. |
+ group's deps. |
``` |
### **Variables** |
``` |
- Deps: data_deps, deps, forward_dependent_configs_from, public_deps |
+ Deps: data_deps, deps, public_deps |
Dependent configs: all_dependent_configs, public_configs |
``` |
@@ -2005,7 +1998,7 @@ |
Flags: cflags, cflags_c, cflags_cc, cflags_objc, cflags_objcc, |
defines, include_dirs, ldflags, lib_dirs, libs, |
precompiled_header, precompiled_source |
- Deps: data_deps, deps, forward_dependent_configs_from, public_deps |
+ Deps: data_deps, deps, public_deps |
Dependent configs: all_dependent_configs, public_configs |
General: check_includes, configs, data, inputs, output_name, |
output_extension, public, sources, testonly, visibility |
@@ -2046,7 +2039,7 @@ |
Flags: cflags, cflags_c, cflags_cc, cflags_objc, cflags_objcc, |
defines, include_dirs, ldflags, lib_dirs, libs, |
precompiled_header, precompiled_source |
- Deps: data_deps, deps, forward_dependent_configs_from, public_deps |
+ Deps: data_deps, deps, public_deps |
Dependent configs: all_dependent_configs, public_configs |
General: check_includes, configs, data, inputs, output_name, |
output_extension, public, sources, testonly, visibility |
@@ -2070,7 +2063,7 @@ |
Flags: cflags, cflags_c, cflags_cc, cflags_objc, cflags_objcc, |
defines, include_dirs, ldflags, lib_dirs, libs, |
precompiled_header, precompiled_source |
- Deps: data_deps, deps, forward_dependent_configs_from, public_deps |
+ Deps: data_deps, deps, public_deps |
Dependent configs: all_dependent_configs, public_configs |
General: check_includes, configs, data, inputs, output_name, |
output_extension, public, sources, testonly, visibility |
@@ -3725,56 +3718,6 @@ |
``` |
-## **forward_dependent_configs_from** |
- |
-``` |
- A list of target labels. |
- |
- DEPRECATED. Use public_deps instead which will have the same effect. |
- |
- Exposes the public_configs from a private dependent target as |
- public_configs of the current one. Each label in this list |
- must also be in the deps. |
- |
- Generally you should use public_deps instead of this variable to |
- express the concept of exposing a dependency as part of a target's |
- public API. We're considering removing this variable. |
- |
-``` |
- |
-### **Discussion** |
- |
-``` |
- Sometimes you depend on a child library that exports some necessary |
- configuration via public_configs. If your target in turn exposes the |
- child library's headers in its public headers, it might mean that |
- targets that depend on you won't work: they'll be seeing the child |
- library's code but not the necessary configuration. This list |
- specifies which of your deps' direct dependent configs to expose as |
- your own. |
- |
-``` |
- |
-### **Examples** |
- |
-``` |
- If we use a given library "a" from our public headers: |
- |
- deps = [ ":a", ":b", ... ] |
- forward_dependent_configs_from = [ ":a" ] |
- |
- This example makes a "transparent" target that forwards a dependency |
- to another: |
- |
- group("frob") { |
- if (use_system_frob) { |
- deps = ":system_frob" |
- } else { |
- deps = "//third_party/fallback_frob" |
- } |
- forward_dependent_configs_from = deps |
- } |
- |
``` |
## **include_dirs**: Additional include directories. |