diff options
author | Ulf Adams <ulfjack@google.com> | 2016-06-23 11:44:08 +0000 |
---|---|---|
committer | Philipp Wollermann <philwo@google.com> | 2016-06-23 13:54:11 +0000 |
commit | 25f4404f79456b07903de987f2c3a1c9eedd53cd (patch) | |
tree | 52b08a337498a28335a2e2e1d262bcea27dabe02 /site/command-line-reference-prefix.html | |
parent | 65c3e36d41f5682a2c3cf6e77c88bd08a86b9670 (diff) |
Update the command-line-reference template for internal use.
--
MOS_MIGRATED_REVID=125665112
Diffstat (limited to 'site/command-line-reference-prefix.html')
-rw-r--r-- | site/command-line-reference-prefix.html | 21 |
1 files changed, 10 insertions, 11 deletions
diff --git a/site/command-line-reference-prefix.html b/site/command-line-reference-prefix.html index ff0e03537a..86516b84e9 100644 --- a/site/command-line-reference-prefix.html +++ b/site/command-line-reference-prefix.html @@ -2,23 +2,22 @@ layout: documentation title: Command-Line Reference --- - <h1>Command-Line Reference</h1> <pre> -blaze [<startup options>] <command> [<args>] +bazel [<startup options>] <command> [<args>] </pre> or <pre> -blaze [<startup options>] <command> [<args>] -- [<target patterns>] +bazel [<startup options>] <command> [<args>] -- [<target patterns>] </pre> <h2>Option Syntax</h2> <p> -Options can be passed to Blaze in different ways. Options that require a value +Options can be passed to Bazel in different ways. Options that require a value can be passed with either an equals sign or a space: <pre> --<option>=<value> @@ -65,7 +64,7 @@ or force-disabled as follows: <p> A target pattern refers to a single or more targets, which are source files, output files, or rules specified in BUILD files. In addition to plain labels, -Blaze also supports working-directory-relative labels, recursive patterns, and +Bazel also supports working-directory-relative labels, recursive patterns, and target subtraction. </p> @@ -108,7 +107,7 @@ workspace. Targets with <code>tags=["manual"]</code> are not included in wildcard target patterns (<code>...</code>, <code>:*</code>, <code>:all</code>, etc). Specify such test targets with explicit labels on the command line if -you want Blaze to build/test them. +you want Bazel to build/test them. </p> <p> @@ -162,7 +161,7 @@ symlinks that are created in the root directory of the workspace. </p> <p> -In addition, Blaze does not follow symlinks when evaluating recursive target +In addition, Bazel does not follow symlinks when evaluating recursive target patterns in any directory that contains a file named as follows: <pre> DONT_FOLLOW_SYMLINKS_WHEN_TRAVERSING_THIS_DIRECTORY_VIA_A_RECURSIVE_TARGET_PATTERN @@ -171,14 +170,14 @@ DONT_FOLLOW_SYMLINKS_WHEN_TRAVERSING_THIS_DIRECTORY_VIA_A_RECURSIVE_TARGET_PATTE <p> Target patterns may be preceded by a single dash ('<code>-</code>'), in which -case Blaze subtracts them from the set of targets accumulated by preceding +case Bazel subtracts them from the set of targets accumulated by preceding patterns. Note that this means <em>order matters</em>. In order to pass negative -target patterns, you need to use '--' as an argument to prevent Blaze from +target patterns, you need to use '--' as an argument to prevent Bazel from interpreting it as an option, e.g.: <pre> -blaze build -- foo/... -foo/contrib/... +bazel build -- foo/... -foo/contrib/... </pre> -Note that Blaze may still build targets matched by a negative target pattern due +Note that Bazel may still build targets matched by a negative target pattern due to dependencies, and may also load the corresponding BUILD files, even if the targets are never built. </p> |