aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/docs/bazel-user-manual.html
Commit message (Collapse)AuthorAge
* Document that ctrl-\ causes Bazel to dump its threads to its jvm.out file, ↵Gravatar Janak Ramakrishnan2016-01-07
| | | | | | | to aid in diagnosing issue #748. -- MOS_MIGRATED_REVID=111360258
* Further improve sandbox documentation.Gravatar Philipp Wollermann2015-12-10
| | | | | -- MOS_MIGRATED_REVID=109881691
* Improve sandboxing documentationGravatar Damien Martin-Guillerez2015-12-10
| | | | | | | | | | - Add mitigation of the common problem to the documentation - Add indication on how to activate sandboxing on some machine (GKE nodes for example) Fixes #433 -- MOS_MIGRATED_REVID=109879921
* Refactor external repository support significantly to solve a number of issues.Gravatar Lukacs Berki2015-12-09
| | | | | | | | | | | | | | | In particular: - Separate the implementation of maven_server into a RepositoryFunction and one that creates the MavenServerValue (ideally, maven_server wouldn't exist but we'll have to make to for the time being) - Refactor the logic of determining whether an external repository needs to be re-fetched to RepositoryDelegatorFunction - Make RepositoryFunctions not be SkyFunctions anymore (they are called from RepositoryDelegatorFunction, though, who *is* a SkyFunction) - Add a Skyframe dirtiness checker that makes --nofetch RepositoryValues not be cached - Add a bunch of test cases and javadoc There is only one wart that I know of that remains: changes to BUILD files of new_* repository rules that weren't refetched when their RepositoryValue was initiall created on server restart won't take effect. This is because we don't add those BUILD files to the created RepositoryValue. This will fix itself once the ExternalFilesHelper refactoring is submitted. -- MOS_MIGRATED_REVID=109768345
* Explicitly mention that 'manual' test targets are not matched by wildcard ↵Gravatar Nathan Harmata2015-12-03
| | | | | | | target patterns and are thus neither built nor tested by invocations like "blaze test //my/project/..." -- MOS_MIGRATED_REVID=109251573
* Do not recurse into the convenience symlinks when evaluating the "//..." ↵Gravatar Lukacs Berki2015-11-20
| | | | | | | | | target pattern. Apart from the tests, I also tested this manually running "bazel query //..." in a tree with convenience symlinks. -- MOS_MIGRATED_REVID=108325454
* Mention --host_crosstool_top in the docs where it's relevantGravatar Brian Silverman2015-11-20
| | | | | | | | | | I filed #546 because I didn't notice --host_crosstool_top does what I want. -- Change-Id: Ib219753ad69c3026f1aa6d1889a0e7fac4449b2b Reviewed-on: https://bazel-review.googlesource.com/#/c/2261/ MOS_MIGRATED_REVID=108267036
* Run bazel documentation tests on mac/linux.Gravatar Dmitry Lomov2015-11-19
| | | | | | | Also, fix said documentation. -- MOS_MIGRATED_REVID=108247791
* Open source BazelDocumentationTest (and fix documentation).Gravatar Dmitry Lomov2015-11-19
| | | | | -- MOS_MIGRATED_REVID=108145081
* Optionally allow Bazel to pass JVM options containing spaces directly ↵Gravatar Janak Ramakrishnan2015-11-16
| | | | | | | | | through to the JVM instead of (almost certainly incorrectly) splitting the options along spaces. This allows us to pass non-quote-delimited strings to the JVM, which is necessary for things like -XX:OnOutOfMemoryError="kill -3 %p" (normally bash strips those quotes, but they're not stripped when passed via --host_jvm_args). -- MOS_MIGRATED_REVID=107820087
* RELNOTES: Symlink dirents of directories containing a file named ↵Gravatar Nathan Harmata2015-11-13
| | | | | | | | | | | | | | "DONT_FOLLOW_SYMLINKS_WHEN_TRAVERSING_THIS_DIRECTORY_VIA_A_RECURSIVE_TARGET_PATTERN" will *not* be traversed for transitive target patterns. The motivation here is to allow directories that intentionally contain wonky symlinks (e.g. foo/bar -> foo) to opt out of being consumed by Blaze. For example, given <workspace>/foo bar bad -> . DONT_FOLLOW_SYMLINKS_WHEN_TRAVERSING_THIS_DIRECTORY_VIA_A_RECURSIVE_TARGET_PATTERN the 'bad' symlink will *not* be traversed by the pattern '//foo/...'. -- MOS_MIGRATED_REVID=107738930
* Update links in Bazel docs to point to new BE pages.Gravatar David Chen2015-11-02
| | | | | | | Fixes #529 -- MOS_MIGRATED_REVID=106883457
* Changes from [] that were left out of theGravatar Brian Silverman2015-11-02
| | | | | | | | | | | | | | previous commit Document and test how rules can run without the sandbox. The only documentation about usable tags values was in a weird place, along with duplicated information about flaky tests. -- Change-Id: Ib98a0a5c582890512161ecf9f5d89c8e78d9ad68 Reviewed-on: https://bazel-review.googlesource.com/#/c/2220 MOS_MIGRATED_REVID=106858070
* Split Build Encyclopedia into multiple pages.Gravatar David Chen2015-10-23
| | | | | -- MOS_MIGRATED_REVID=106092764
* Fix profiling doc missing in Bazel manualGravatar Klaas Boesche2015-10-21
| | | | | -- MOS_MIGRATED_REVID=105952522
* Document the --spawn_strategy and --genrule_strategy flag in the user manual.Gravatar Philipp Wollermann2015-10-09
| | | | | -- MOS_MIGRATED_REVID=104958733
* Bazel user manual: simplify the documentation of Sandboxing.Gravatar Laszlo Csomor2015-10-05
| | | | | -- MOS_MIGRATED_REVID=104644891
* Mention chroot in --batch description.Gravatar Han-Wen Nienhuys2015-09-25
| | | | | | | Fixes #134. -- MOS_MIGRATED_REVID=103935102
* Add an example of using a regex with negative lookup in --output_filter.Gravatar Nathan Harmata2015-09-02
| | | | | | | I promised to add this example after responding to a user question in the bazel irc. -- MOS_MIGRATED_REVID=102120516
* Collect Skylark profile info and create HTML statistics when --html_details ↵Gravatar Googler2015-09-02
| | | | | | | given -- MOS_MIGRATED_REVID=102046602
* Normalize usage of "workspace", "workspace directory" and "build root" inGravatar Googler2015-08-31
| | | | | | | | | | | | | | | documentation. Replaces instances of "build root" with "workspace directory" as appropriate. Makes the following changes: - /docs/build-ref.html: Adds definition of workspace - /docs/external.md: Replaces "build root" terminology with "workspace" - /docs/getting-started.md: Adds link to workspace definition - /docs/bazel-user-manual.html: Adds link to workspace definition -- MOS_MIGRATED_REVID=101885966
* Also add "bazel version" to the table of contents of the User's Guide. Not ↵Gravatar Lukacs Berki2015-08-26
| | | | | | | my best day today. -- MOS_MIGRATED_REVID=101557371
* Add the "version" and "mobile-install" commands to the User's Guide.Gravatar Lukacs Berki2015-08-26
| | | | | -- MOS_MIGRATED_REVID=101555906
* Make sandboxed execution the default in Bazel. This should be safe, as the ↵Gravatar Philipp Wollermann2015-08-26
| | | | | | | strategy is only used if your Linux kernel is new enough and your running system supports it. If this breaks you, please file a bug and you can always go back to non-sandboxed execution by using --spawn_strategy=standalone. -- MOS_MIGRATED_REVID=101464269
* Clarify behavior of --announce_rc.Gravatar Janak Ramakrishnan2015-08-11
| | | | | -- MOS_MIGRATED_REVID=100315352
* Clarify units of argument to --iff_heap_size_greater_than.Gravatar Googler2015-08-11
| | | | | -- MOS_MIGRATED_REVID=100303875
* Fix --batch link in blaze user manual to match other flags.Gravatar Googler2015-08-05
| | | | | | | RELNOTES: nope -- MOS_MIGRATED_REVID=99931043
* Rollforward of []: Blaze changes to support LLVM profile feedbackGravatar Googler2015-07-23
| | | | | | | Rollback of commit b961bb931400044ed91e6b0b596f94fe983f9f17. -- MOS_MIGRATED_REVID=98833728
* Add --output_filter optionGravatar Kristina Chodorow2015-07-21
| | | | | | | Fixes #309. -- MOS_MIGRATED_REVID=98639996
* Document that the "run" command closes stdin.Gravatar Philipp Wollermann2015-07-17
| | | | | -- MOS_MIGRATED_REVID=98393704
* Rollback of commit 69d20b26b50360221849a4860265150f9c66ef25.Gravatar Lukacs Berki2015-07-17
| | | | | | | | | | | | | *** Reason for rollback *** Breaks LIPO, [] *** Original change description *** Blaze changes to support LLVM profile feedback. -- MOS_MIGRATED_REVID=98382087
* Blaze changes to support LLVM profile feedback.Gravatar Googler2015-07-07
| | | | | -- MOS_MIGRATED_REVID=97610963
* Fix what I assume to be a typo.Gravatar Googler2015-07-02
| | | | | | | The alternative is too horrifying to consider. -- MOS_MIGRATED_REVID=97398060
* Fix Blaze/Bazel mixup in docsGravatar Googler2015-06-26
| | | | | -- MOS_MIGRATED_REVID=96911530
* Externalize documentation for -extra_checksGravatar Liam Miller-Cushon2015-06-25
| | | | | -- MOS_MIGRATED_REVID=96814231
* Fix documentation about master configuration filesGravatar Damien Martin-Guillerez2015-06-25
| | | | | -- MOS_MIGRATED_REVID=96802902
* Delete documentation for 'server_log' info item. This doesn't currently ↵Gravatar Nathan Harmata2015-06-24
| | | | | | | exist and hasn't existed for a while. -- MOS_MIGRATED_REVID=96711367
* Documentation: fix docs of value of --show_progress_rate_limit.Gravatar Laszlo Csomor2015-06-18
| | | | | | | Default value was wrong and semantics were not documented in enough detail. -- MOS_MIGRATED_REVID=96312299
* A minor refactoring.Gravatar Lukacs Berki2015-06-10
| | | | | -- MOS_MIGRATED_REVID=95612927
* Add documentation for --javac_extdirGravatar Liam Miller-Cushon2015-06-09
| | | | | | | Also update --javac_bootclasspath, and mention cross-compiling. -- MOS_MIGRATED_REVID=95481485
* Remove the documentation for the now-nonexistent "bazel rm" command (was ↵Gravatar Lukacs Berki2015-06-08
| | | | | | | removed in []) -- MOS_MIGRATED_REVID=95433212
* Add details for the --config flag. Existing wording uses a plural 'sections',Gravatar Googler2015-06-08
| | | | | | | | | but it is not clear how multiple sections should be specified. Also, given that some flags overwrite previous values, I think that explicit instructions make the behavior clearer. -- MOS_MIGRATED_REVID=95417384
* Remove fetch step from compile.shGravatar Kristina Chodorow2015-06-01
| | | | | | | | | | Also updates the fetch documentation. Now that it's been in the wild for a bit, keeping --fetch=true the default seems like the right choice: it's less confusing to new users and anyone who cares can put `build --fetch=false` in their .bazelrc file. -- MOS_MIGRATED_REVID=94912125
* Better distinguish subcommand log statements by logging descriptionGravatar Mark Schaller2015-05-18
| | | | | | | | Now, when subcommands are logged due to the -s option, the action's description is logged in an bracketed note after the label. -- MOS_MIGRATED_REVID=93886445
* RELNOTES[INC]: Remove deprecated "make var" INCDIRGravatar Han-Wen Nienhuys2015-05-18
| | | | | -- MOS_MIGRATED_REVID=93877298
* Documentation for the fetch commandGravatar Kristina Chodorow2015-05-15
| | | | | | | I'm expecting some complaints once it's required. -- MOS_MIGRATED_REVID=93318895
* Update bazel --cpu= docs to remove hardcoded arch strings.Gravatar Googler2015-05-01
| | | | | -- MOS_MIGRATED_REVID=92573465
* Removing documentation about non-functionnal flags.Gravatar Damien Martin-Guillerez2015-04-20
| | | | | | | Fix #140 -- MOS_MIGRATED_REVID=91581443
* Remove autosense logic.Gravatar Han-Wen Nienhuys2015-04-14
| | | | | | | | | | | | | Polling the machine load can never work, because the following scenarios are quite common: * Tasks that are faster than the poll cycle time. * Tasks whose CPU and/or RAM consumption changes over the lifetime of the task. -- MOS_MIGRATED_REVID=90990445
* Change the mover paths for docs to be under site/Gravatar Kristina Chodorow2015-04-03
-- MOS_MIGRATED_REVID=90252678