examples/rule_based_toolchain/README.md

# Rule-based toolchains
This example showcases a fully working rule-based toolchain for Linux. This also
serves as an integration test to ensure rule-based toolchains continue to work
as intended.

The complete toolchain configuration lives [here](https://github.com/bazelbuild/rules_cc/tree/main/examples/rule_based_toolchain/toolchains).

# Trying the example
From this directory, you can run example tests that build using this toolchain
with the following command:
```
$ bazel test //...
```

This example currently only supports Linux.

By default, it will build with `clang`. To use `gcc`, try the following command:

```
$ bazel test --config=gcc //...
```