aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/docs
Commit message (Collapse)AuthorAge
* Replace doc pages with redirects to versioned doc pages.Gravatar David Chen2016-08-29
| | | | | | | | | | | | | | * Add a new `redirect` Jekyll layout. * Replace all pages under docs/ with redirects to corresponding page under versions/master/. * Prepend links on Documentation sidebar, including generated navs for the Skylark Library and Build Encyclopedia, with prefix for versioned directory. * Add code to both the internal jekyll-config.sh and external jekyll-tree.sh to add redirect pages for the Skylark Library and Build Encyclopedia. * Bring the branched User Manual doc up to date with latest changes. -- MOS_MIGRATED_REVID=131568800
* Correct links to windows-support issues listGravatar Peter Mounce2016-08-25
| | | | | | | | | | I elected to update the old blog posts too, since finding bazel via those is quite likely. Closes #1657. -- Reviewed-on: https://github.com/bazelbuild/bazel/pull/1657 MOS_MIGRATED_REVID=131288540
* Remove support for thin archives.Gravatar Lukacs Berki2016-08-23
| | | | | -- MOS_MIGRATED_REVID=130938527
* Update the query documentation to reflect the fact that locations printed ↵Gravatar Lukacs Berki2016-08-22
| | | | | | | are always within BUILD files. -- MOS_MIGRATED_REVID=130936412
* Fix typos: min_rank -> minrank, max_rank -> maxrankGravatar Googler2016-08-18
| | | | | -- MOS_MIGRATED_REVID=130631646
* DOC: Fix typo (unclosed string)Gravatar Gustav Larsson2016-08-12
| | | | | | | | | | Small typo fix in documentations. Closes #1629. -- Reviewed-on: https://github.com/bazelbuild/bazel/pull/1629 MOS_MIGRATED_REVID=129985238
* Rewords the rules pitfall documentGravatar Damien Martin-Guillerez2016-08-05
| | | | | | | So it stop suggesting that it is hard to write rules, though it is not easy to write good rules :) -- MOS_MIGRATED_REVID=129423968
* Update windows.md againGravatar Yun Peng2016-08-04
| | | | | -- MOS_MIGRATED_REVID=129305218
* --Gravatar Googler2016-08-01
| | | | MOS_MIGRATED_REVID=128827694
* Move Skyframe page from doc/ to designs/.Gravatar David Chen2016-07-29
| | | | | -- MOS_MIGRATED_REVID=128793556
* Move designs/ directory out of docs/ and into site root.Gravatar David Chen2016-07-29
| | | | | | | | | | | For versioning Bazel's documentation, we only want to version the pages under the Documentation portion of the site. Since Design Docs are more meant for Bazel developers and are generally not continually updated for each release, we should not version the design docs. Moving the directory for the design docs out of docs/ will also simplify the change for versioning Bazel's docs. -- MOS_MIGRATED_REVID=128788588
* Use correct layout for design docs pages.Gravatar David Chen2016-07-29
| | | | | | | Fixes #1545 -- MOS_MIGRATED_REVID=128751593
* Move Rule Pitfalls doc to Documentation.Gravatar David Chen2016-07-29
| | | | | | | Fixes #1544 -- MOS_MIGRATED_REVID=128736865
* Rollback of commit 3e8bcae69a0718cf6972be086706b1841e0ed6b7.Gravatar Damien Martin-Guillerez2016-07-29
| | | | | | | | | | | | | | | | | | | | | | | | | | *** Reason for rollback *** Breaks design docs links *** Original change description *** Move Bazel docs into versioned directory. * Move all Bazel docs (excluding main page, search page, and blog) into versions/master directory. * Replace all original pages with redirects. * Add Jekyll config with default_version setting to specify the default version to redirect docs to. * Add Jekyll config with version_prefix setting specific to pages under each version directory. * Update layouts to generate links to pages for the same version with the version_prefix. * Update Blaze rel... *** -- MOS_MIGRATED_REVID=128690580
* Add README to original Bazel docs directory to point developers to the correctGravatar David Chen2016-07-27
| | | | | | | | | directory to make documentation changes. Bug: #579 -- MOS_MIGRATED_REVID=128533607
* Move Bazel docs into versioned directory.Gravatar David Chen2016-07-27
| | | | | | | | | | | | | | | | | | | | | | | | | | * Move all Bazel docs (excluding main page, search page, and blog) into versions/master directory. * Replace all original pages with redirects. * Add Jekyll config with default_version setting to specify the default version to redirect docs to. * Add Jekyll config with version_prefix setting specific to pages under each version directory. * Update layouts to generate links to pages for the same version with the version_prefix. * Update Blaze release script to copy docs from third_party/bazel/site/versions/master Changes to follow this CL: * Separate navigation from layouts so that navigation can be versioned as well. * Add tool for cutting a release of Bazel docs and copies them into a new version directory. Bug: #579 -- MOS_MIGRATED_REVID=128510319
* Typo fixes in markdown and javadoc as suggested by intellij typo inspection.Gravatar Googler2016-07-27
| | | | | -- MOS_MIGRATED_REVID=128476121
* Restructured installation instructions.Gravatar Dmitry Lomov2016-07-27
| | | | | | | The structure is now: Platform, installation method. -- MOS_MIGRATED_REVID=128461668
* Allow lists to be modified while a For loop is iterating over them.Gravatar Jon Brandvein2016-07-26
| | | | | | | | This does not affect the loop's iteration. Similar work is needed for comprehension For clauses. -- MOS_MIGRATED_REVID=128357769
* Fixup newly added cookbook exampleGravatar Brian Silverman2016-07-25
| | | | | | | | | | | | I think `cc_binary = cc_binary` was a typo because I don't see what it was referring to, and prohibiting anybody else from depending on an internal rule that's effectively an implementation detail seems like a good practice. -- Change-Id: I9f51e6844bede6564c980699996b22c3d0978981 Reviewed-on: https://bazel-review.googlesource.com/#/c/3740/ MOS_MIGRATED_REVID=128336843
* Clean up minor issues in C++/Java tutorialsGravatar David Herman2016-07-22
| | | | | | | | | | | | Hello, I work for Google but am currently contributing this as an individual. I'm interested in learning Bazel on the side, and as I'm going through the docs, I thought I'd submit code reviews for misc. Bazel site cleanup that I came across (especially for guides that act as a first impression for new users). Let me know if you'd prefer I submit this patch in a different way. Thanks! Closes #1530. -- Reviewed-on: https://github.com/bazelbuild/bazel/pull/1530 MOS_MIGRATED_REVID=128174882
* Clean up minor spelling / grammar in Getting Started pageGravatar David Herman2016-07-21
| | | | | | | | | | | | Hello, I work for Google but am currently contributing this as an individual. I'm interested in learning Bazel on the side, and as I'm going through the docs, I thought I'd submit code reviews for misc. Bazel site cleanup that I came across (especially for guides that act as a first impression for new users). Let me know if you'd prefer I submit this patch in a different way. Thanks! Closes #1529. -- Reviewed-on: https://github.com/bazelbuild/bazel/pull/1529 MOS_MIGRATED_REVID=128035787
* clarified needing to run generate_workspace from bazel source folderGravatar Ittai Zeidman2016-07-14
| | | | | | | | | | | Hi, If you feel this is unnecessary please feel free to close this PR but it took me some time and @lberki's help to understand that even though I built the binary from source and I have the source cloned then I still need to run the command from the source folder so I added that note in. Closes #1489. -- Reviewed-on: https://github.com/bazelbuild/bazel/pull/1489 MOS_MIGRATED_REVID=127429574
* Fix deb command to download for the right architectureGravatar Kristina Chodorow2016-07-14
| | | | | | | Fixes #1512. -- MOS_MIGRATED_REVID=127304483
* Fix a couple of links in documentationGravatar Googler2016-07-07
| | | | | -- MOS_MIGRATED_REVID=126803908
* Add doc on how to "install" the bazel binaryGravatar Kristina Chodorow2016-07-07
| | | | | | | As mentioned in https://groups.google.com/d/msgid/bazel-discuss/cebcf019-fcb4-4d7b-87be-1a3922b15e77%40googlegroups.com. -- MOS_MIGRATED_REVID=126697864
* Add allow_single_file in attr.label, deprecate single_file.Gravatar Laurent Le Brun2016-07-05
| | | | | -- MOS_MIGRATED_REVID=126620866
* Deprecate DATA_CFG and HOST_CFG, use string 'data' and 'host' instead.Gravatar Laurent Le Brun2016-07-04
| | | | | -- MOS_MIGRATED_REVID=126572660
* Make java_classpath flag non-experimentalGravatar Liam Miller-Cushon2016-07-01
| | | | | -- MOS_MIGRATED_REVID=126310706
* Add status information to the design documentsGravatar Klaus Aehlig2016-07-01
| | | | | | | | | | | As we also collect design documents on unimplemented designs, it is important to keep status information with our design documents. -- Change-Id: I3e08a8b05daf7a0c7f12cffbe4a8e350de5e34f8 Reviewed-on: https://bazel-review.googlesource.com/#/c/3943 MOS_MIGRATED_REVID=126307804
* Add design documents to the navigationGravatar Klaus Aehlig2016-07-01
| | | | | | | | | | We already have some design documents committed to our documentation pages. Add an index of those, under the 'Contribute!' section. -- Change-Id: I9331f13d9f145668991f26dd301c10b4a7f06216 Reviewed-on: https://bazel-review.googlesource.com/#/c/3942 MOS_MIGRATED_REVID=126300855
* Skylark documentation update: callback functions have to list the required ↵Gravatar Florian Weikert2016-07-01
| | | | | | | attributes as their parameters (instead of using an attribute map). -- MOS_MIGRATED_REVID=126298988
* Minor fixes to the Bazel documentation.Gravatar Florian Weikert2016-07-01
| | | | | -- MOS_MIGRATED_REVID=126298962
* Some cleanup in skylark cookbook/macros docGravatar Laurent Le Brun2016-06-29
| | | | | -- MOS_MIGRATED_REVID=126104630
* 2016-06-02-sandboxing.md: fix titleGravatar Klaus Aehlig2016-06-28
| | | | | | | | | | | The main contribution of that design document is the sandbox set up. Environment variables are only a small aspect of that design (and superseded by now). -- Change-Id: I831704d63f02125eea83106d6bf4c78876f91701 Reviewed-on: https://bazel-review.googlesource.com/#/c/3911 MOS_MIGRATED_REVID=126049324
* Document that Visual Studio is now required for building Bazel.Gravatar Lukacs Berki2016-06-28
| | | | | -- MOS_MIGRATED_REVID=126044624
* Add sandboxing design doc from philwo.Gravatar Ulf Adams2016-06-27
| | | | | | | -- Change-Id: Ib40fac6a616805defbf972f7eadd333e3e187335 Reviewed-on: https://bazel-review.googlesource.com/#/c/3891/1 MOS_MIGRATED_REVID=125954946
* Update concepts / BUILD files page.Gravatar Tobias Werth2016-06-27
| | | | | -- MOS_MIGRATED_REVID=125952754
* getting-started.md: fix typo in URLGravatar Klaus Aehlig2016-06-27
| | | | | | | -- Change-Id: Iab790f363ce1029da9706be6be176e4320bdcdb9 Reviewed-on: https://bazel-review.googlesource.com/#/c/3906 MOS_MIGRATED_REVID=125951789
* Replace "Getting Started" page by a Bazel "Hello World"Gravatar Klaus Aehlig2016-06-27
| | | | | | | | | | | | | | As we have a tutorial anyway, keep the "Getting started" page short and language agnositic, and do not duplicate parts that are taught in the tutorial anyway. The main purpose of the "Getting Started" page is to give the reader a quick feeling of the very basic Bazel concepts, as well as allowing to test if Bazel is installed correctly. -- Change-Id: I80baae1c424244d492c202eff0c613cbac187d43 Reviewed-on: https://bazel-review.googlesource.com/#/c/3882 MOS_MIGRATED_REVID=125796405
* - Move Java-specific content to Java landing pageGravatar Yun Peng2016-06-27
| | | | | | | | - Turn C++ Basic into a C++ language landing page - Reorganized tutorial menu -- MOS_MIGRATED_REVID=125796335
* Do not require users to set TMPDIR for bootstrap on Windows.Gravatar Dmitry Lomov2016-06-24
| | | | | | | | | Fixes 1444. -- Change-Id: If9afa2bebcd35b0c0882685588d8e1f3b18f5344 Reviewed-on: https://bazel-review.googlesource.com/#/c/3890/ MOS_MIGRATED_REVID=125771832
* Corrected date of the design doc on Specifying environment variablesGravatar Damien Martin-Guillerez2016-06-24
| | | | | -- MOS_MIGRATED_REVID=125764633
* Add a design document on about specifying environment variablesGravatar Klaus Aehlig2016-06-24
| | | | | | | | | | | | A lot of suggestions have been made about how the environment, in particular the PATH environment variable, should or should not influence the build. This design document suggests a solution that tries to be flexible enough to make all desired use cases possible in some way. -- Change-Id: I623ce880d6266625fea1213fa9f7c2bfe1a519df Reviewed-on: https://bazel-review.googlesource.com/#/c/3850 MOS_MIGRATED_REVID=125763387
* Clarify documentation of type() - behavior might change in the future.Gravatar Laurent Le Brun2016-06-24
| | | | | | | Also, update difference with Python that was dropped from commit 1c88f9cfafcd7f8856066a0ca4531ca2fc92c5bd -- MOS_MIGRATED_REVID=125711726
* Document more differences with Python: nested functions and for loopsGravatar Laurent Le Brun2016-06-24
| | | | | -- MOS_MIGRATED_REVID=125694309
* - Rename "Test Encyclopedia" to "Writing Tests"Gravatar Yue Gan2016-06-24
| | | | | | | | | - Remove non-existing links and add contents of the links - Document runfiles (from the Runfiles doc) - Deprecate JAVA_RUNFILES -- MOS_MIGRATED_REVID=125691421
* Fix invalid jekyll markdown by replacing it with explicit HTML.Gravatar Tobias Werth2016-06-23
| | | | | -- MOS_MIGRATED_REVID=125669112
* Remove word "Skylark" from documentation.Gravatar Laurent Le Brun2016-06-23
| | | | | | | Text becomes somewhat clearer without using this codename. -- MOS_MIGRATED_REVID=125561237
* install.md: Give clear guidance to users on which installation strategy to useGravatar Yun Peng2016-06-23
| | | | | -- MOS_MIGRATED_REVID=125558863