aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/docs/skylark/cookbook.md
Commit message (Collapse)AuthorAge
* Add redirect from skylark/index.html to skylark/concepts.html.Gravatar David Z. Chen2017-11-30
| | | | | | Closes #4140. PiperOrigin-RevId: 177515494
* Fixes scripts/serve-docs.shGravatar vladmos2017-11-21
| | | | | | The serve-docs.sh script uses pygments for formatting code fragments which fails with "no lexer for alias 'shell' found" PiperOrigin-RevId: 176503221
* blaze: cookbook: properly quote shell variablesGravatar mpn2017-10-20
| | | | | | | | | Using $* is an abomination. Use properly quoted $@ instead in the example merge.sh script. While at it, fix the syntax highlighting (merge.sh is shell code not Python). RELNOTES: Improved merge.sh script in cookbook. PiperOrigin-RevId: 172789316
* Skylark doc: add table of contents hintsGravatar dmarting2017-09-18
| | | | PiperOrigin-RevId: 168818956
* PiperOrigin-RevId: 168816247Gravatar dmarting2017-09-18
|
* Documentation cleanup.Gravatar dmarting2017-09-12
| | | | PiperOrigin-RevId: 168218117
* Add links to examples in the documentation.Gravatar laurentlb2017-07-24
| | | | | RELNOTES: None. PiperOrigin-RevId: 162738376
* Use new actions API in docs.Gravatar Dmitry Lomov2017-07-21
| | | | | Change-Id: Ibbc41193ca3f577fbbd1674e9dd1c7f04a246e93 PiperOrigin-RevId: 162612615
* Use double-quotes instead of single-quotes for consistency.Gravatar laurentlb2017-07-20
| | | | | RELNOTES: None. PiperOrigin-RevId: 162518452
* Restructure site/ directory into docs/ which only contains Bazel documentation.Gravatar dzc2017-06-01
| | | | | | | | | | | | | | | | | | | | | | | | | | | | The new docs/ directory in the bazel source tree will only contain the Bazel docs site, which is hosted at docs.bazel.build. This change deletes the marketing site and blog, which have been migrated to the bazel-website and bazel-blog GitHub repositories respectively. This change also updates the serve-docs.sh and ci/build.sh under scripts/ in preparation for publishing the docs site. Note that to help make reviews more manageable, this change is limited to moving files to their new locations. Here are the follow-up changes: * Update all links in docs to remove versions/master in paths and to add correct bazel.build subdomain when linking to pages on the marketing site or the blog. * Set up versioned directories on GCS bucket and add tooling for versioning docs This change is also coordinated with https://bazel-review.googlesource.com/c/11568/ to have the PublishSite job publish to docs.bazel.build rather than www.bazel.build. Issue #2397 RELNOTES: None PiperOrigin-RevId: 157612651
* 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
* 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
* 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
* 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
* Deprecate DATA_CFG and HOST_CFG, use string 'data' and 'host' instead.Gravatar Laurent Le Brun2016-07-04
| | | | | -- MOS_MIGRATED_REVID=126572660
* 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
* Some cleanup in skylark cookbook/macros docGravatar Laurent Le Brun2016-06-29
| | | | | -- MOS_MIGRATED_REVID=126104630
* Fix typo in skylark cookbookGravatar Googler2016-05-24
| | | | | -- MOS_MIGRATED_REVID=123071294
* Docs demonstrating a macro combining Skylark and native rules.Gravatar Googler2016-05-24
| | | | | -- MOS_MIGRATED_REVID=123016395
* Add some cross referencing to the cookbook and standardize header style for ↵Gravatar Dave MacLachlan2016-03-01
| | | | | | | markdown. -- MOS_MIGRATED_REVID=116007304
* Fix load() examples to use build targets instead of file paths.Gravatar Googler2016-02-25
| | | | | -- MOS_MIGRATED_REVID=115492703
* Looks to me like the example was slightly broken, I think this fixes it.Gravatar Googler2016-02-23
| | | | | -- MOS_MIGRATED_REVID=115346303
* Minor style fixes.Gravatar Googler2016-02-19
| | | | | -- MOS_MIGRATED_REVID=115033052
* Add allow_files to cookbook example for using a binary.Gravatar Eric Dobson2016-02-17
| | | | | | | | The example implies that this works for an existing binary, but if the rule is a file then it doesn't work. This changes it so that users will know that the allow_files option exists and they likely want it in this case. -- Reviewed-on: https://github.com/bazelbuild/bazel/pull/892 MOS_MIGRATED_REVID=114849501
* Rename native.rule and native.rules to {existing_rule,existing_rules}Gravatar Han-Wen Nienhuys2016-01-28
| | | | | | | | | | | | This is to avoid confusion between rule(), which declares a new build rules, and native.rule(), which can only be used in macros to inspect the BUILD file processed so far. native.{rule,rules} is maintained and marked deprecated to smooth the transition for early adopters. -- MOS_MIGRATED_REVID=113250194
* Fix double </a> in header.Gravatar Han-Wen Nienhuys2016-01-21
| | | | | -- MOS_MIGRATED_REVID=112598805
* Add titles to Bazel documentation pages.Gravatar David Chen2016-01-20
| | | | | | | Fixes #790 -- MOS_MIGRATED_REVID=112563137
* Add native.rule(NAME), which returns the attributes of a previously defined ↵Gravatar Han-Wen Nienhuys2016-01-15
| | | | | | | | | | | | | | | | | | | | | | | | | | | rule. Add native.rules(), which returns all previously defined rules. These primitives can be used to write Skylark extensions that aggregate over the contents of a BUILD file, eg. def instantiate_if_needed(name): n = name + "_wrapped" if not native.rule(n): py_test(name = n , ... ) def archive_cc_src_files(tag): all_src = [] for r in native.rules().values(): if tag in r["tags"] and r["kind"] == "cc_library": all_src.append(r["srcs"]) native.genrule(cmd = "zip $@ $^", srcs = all_src, outs = ["out.zip"]) RELNOTES: Support aggregation over existing rules in Skylark extensions through native.rules and native.rule. -- MOS_MIGRATED_REVID=112249050
* --Gravatar Googler2015-10-21
| | | | MOS_MIGRATED_REVID=105884504
* Skylark cookbook example: Computed dependenciesGravatar Laurent Le Brun2015-06-17
| | | | | -- MOS_MIGRATED_REVID=96202821
* Fix cookbook: simple shell command documentation to match sample code.Gravatar Googler2015-06-11
| | | | | -- MOS_MIGRATED_REVID=95732949
* Skylark cleanup: ctx.target(s) is deprecated, stop using itGravatar Laurent Le Brun2015-05-21
| | | | | | | ctx.attr gives the same result. -- MOS_MIGRATED_REVID=94077958
* Skylark: Improve documentation related to Shell commands.Gravatar Laurent Le Brun2015-05-21
| | | | | -- MOS_MIGRATED_REVID=94023360
* Skylark cookbook: Set progress_message in examples.Gravatar Laurent Le Brun2015-05-18
| | | | | -- MOS_MIGRATED_REVID=93889255
* Skylark documentation: Mention implicit attributes.Gravatar Laurent Le Brun2015-05-07
| | | | | -- MOS_MIGRATED_REVID=92937527
* Skylark cookbook example: Execute a binaryGravatar Laurent Le Brun2015-05-07
| | | | | -- MOS_MIGRATED_REVID=92915630
* Cookbook: Style cleanupGravatar Laurent Le Brun2015-05-05
| | | | | -- MOS_MIGRATED_REVID=92826821
* Improvements to bazel.io.Gravatar Googler2015-05-01
| | | | | | | | | | | | | * Move sidebar nav on docs and community pages to left side so that the sidebar shows at the top of the page in mobile. Improve appearance of sidebar nav. * Highlight navbar link depending on current page. * Switch Markdown renderer to Redcarpet to enable Pygments highlighting of fenced code blocks (```python etc.) such as on Skylark Cookbook page. * Change ```build to ```python on Skylark cookbook page. * Minor aesthetic tweaks to Install page * Make style of Feedburner widget consistent with rest of page. * Remove use of site_root from layouts and pages since it is no longer necessary after kchodorow@ added JS to redirect from github.google.com/bazel to bazel.io -- MOS_MIGRATED_REVID=92494349
* Enable accepting external contributions to the Skylark documentation.Gravatar Laszlo Csomor2015-04-15
| | | | | -- MOS_MIGRATED_REVID=91182325
* Fix Skylark cookbook exampleGravatar Laurent Le Brun2015-04-09
| | | | | -- MOS_MIGRATED_REVID=90708017
* Change the mover paths for docs to be under site/Gravatar Kristina Chodorow2015-04-03
-- MOS_MIGRATED_REVID=90252678
generated by cgit v1.2.3 (git 2.39.1) at 2024-07-05 05:57:17 +0000