Index: tools/gn/docs/reference.md |
diff --git a/tools/gn/docs/reference.md b/tools/gn/docs/reference.md |
index c29b24fe6f764be9e011bb83c3924a922c1aa226..4071fd96269f5352920f2695c26ade18c8130848 100644 |
--- a/tools/gn/docs/reference.md |
+++ b/tools/gn/docs/reference.md |
@@ -697,8 +697,8 @@ |
--filters=<path_prefixes> |
Semicolon-separated list of label patterns used to limit the set |
of generated projects (see "gn help label_pattern"). Only |
- matching targets will be included to the solution. Only used for |
- Visual Studio and Xcode. |
+ matching targets and their dependencies will be included in the |
+ solution. Only used for Visual Studio and Xcode. |
``` |
@@ -864,8 +864,8 @@ |
``` |
Finds paths of dependencies between two targets. Each unique path |
will be printed in one group, and groups will be separate by newlines. |
- The two targets can appear in either order: paths will be found going |
- in either direction. |
+ The two targets can appear in either order (paths will be found going |
+ in either direction). |
By default, a single path will be printed. If there is a path with |
only public dependencies, the shortest public path will be printed. |
@@ -876,13 +876,23 @@ |
``` |
+### **Interesting paths** |
+ |
+``` |
+ In a large project, there can be 100's of millions of unique paths |
+ between a very high level and a common low-level target. To make the |
+ output more useful (and terminate in a reasonable time), GN will not |
+ revisit sub-paths previously known to lead to the target. |
+ |
+``` |
+ |
### **Options** |
``` |
--all |
- Prints all paths found rather than just the first one. Public paths |
- will be printed first in order of increasing length, followed by |
- non-public paths in order of increasing length. |
+ Prints all "interesting" paths found rather than just the first |
+ one. Public paths will be printed first in order of increasing |
+ length, followed by non-public paths in order of increasing length. |
--public |
Considers only public paths. Can't be used with --with-data. |
@@ -3611,13 +3621,13 @@ |
``` |
This value should be used to indicate the desired architecture for |
the primary objects of the build. It will match the cpu architecture |
- of the default toolchain. |
+ of the default toolchain, but not necessarily the current toolchain. |
In many cases, this is the same as "host_cpu", but in the case |
- of cross-compiles, this can be set to something different. This |
- value is different from "current_cpu" in that it can be referenced |
- from inside any toolchain. This value can also be ignored if it is |
- not needed or meaningful for a project. |
+ of cross-compiles, this can be set to something different. This |
+ value is different from "current_cpu" in that it does not change |
+ based on the current toolchain. When writing rules, "current_cpu" |
+ should be used rather than "target_cpu" most of the time. |
This value is not used internally by GN for any purpose, so it |
may be set to whatever value is needed for the build. |
@@ -5949,8 +5959,8 @@ |
When a tool produces more than one output, only the first output |
is considered. For example, a shared library target may produce a |
.dll and a .lib file on Windows. Only the .dll file will be considered |
- a runtime dependency. This applies only to linker tools, scripts and |
- copy steps with multiple outputs will also get all outputs listed. |
+ a runtime dependency. This applies only to linker tools. Scripts and |
+ copy steps with multiple outputs will get all outputs listed. |
``` |