Improve the documentation on unquoted words in query expressions

This mentions that $ and @ are allowed in unquoted words (previously omitted). The documentation of the characters allowed in unquoted words is also changed to list punctuation characters in the same relative order and format as the list of punctuation characters allowed in target names in that section of the documentation.

It also lists the full set of characters permitted in target expressions which are not permitted in unquoted words (the documentation previously mentioned + and = only in examples and ~ not at all). It emphasizes the implication of this: When writing code that generates query expressions, target names should be quoted.

A slight tweak is made to the bit about alphanumeric characters, since A-Za-z is not "the set of alphabetic characters" and 0-9 is not "numerals" unless you specify "in ASCII".

RELNOTES: None.
PiperOrigin-RevId: 247435415
1 file changed
tree: 6ff7e57eaba5f2b2b2ac8fa220f7cd1f6e618331
  1. .bazelci/
  2. examples/
  3. scripts/
  4. site/
  5. src/
  6. third_party/
  7. tools/
  8. .bazelrc
  9. .gitattributes
  10. .gitignore
  11. AUTHORS
  12. BUILD
  13. CHANGELOG.md
  14. CODEOWNERS
  15. combine_distfiles.py
  16. combine_distfiles_to_tar.sh
  17. compile.sh
  18. CONTRIBUTING.md
  19. CONTRIBUTORS
  20. distdir.bzl
  21. ISSUE_TEMPLATE.md
  22. LICENSE
  23. README.md
  24. WORKSPACE
README.md

Bazel

{Fast, Correct} - Choose two

Build and test software of any size, quickly and reliably.

  • Speed up your builds and tests: Bazel only rebuilds what is necessary. With advanced local and distributed caching, optimized dependency analysis and parallel execution, you get fast and incremental builds.

  • One tool, multiple languages: Build and test Java, C++, Android, iOS, Go, and a wide variety of other language platforms. Bazel runs on Windows, macOS, and Linux.

  • Scalable: Bazel helps you scale your organization, codebase, and continuous integration solution. It handles codebases of any size, in multiple repositories or a huge monorepo.

  • Extensible to your needs: Easily add support for new languages and platforms with Bazel's familiar extension language. Share and re-use language rules written by the growing Bazel community.

Getting Started

Documentation

Contributing to Bazel

See CONTRIBUTING.md

Build status

Bazel is released in ‘Beta’. See the product roadmap to learn about the path toward a stable 1.0 release.