Age | Commit message (Collapse) | Author | |
---|---|---|---|
6 days | doc: Fix various typos and inconsistencies | Paul Cristian Sarbu | |
10 days | Tutorial: also point to the computed root used in the justbuild repo | Klaus Aehlig | |
10 days | Documentation: fix some typos | Klaus Aehlig | |
2025-06-13 | Extend invocation-logging tutorial | Klaus Aehlig | |
Environment variables can be used to provide some context, why a particular invocation was run, and hence allow additional sharding. Also, remind that setting up a cronjob for log rotation might me a good idea. | |||
2025-06-05 | lint tutorial: hint on the discovered but not processed actions | Klaus Aehlig | |
Linting is a natural example where actions are discovered that are not neded for the artifact that is requested to be built. Use this opportunity to explain the difference between discovering an action and processing it. | |||
2025-06-05 | tutorial lint: Update example output | Paul Cristian Sarbu | |
2025-05-23 | tutorial: Update example outputs in all chapters | Paul Cristian Sarbu | |
...to match the ones produces by latest binaries and rules. | |||
2025-05-23 | tutorial computed: Fix source of non-reproducibility in example script | Paul Cristian Sarbu | |
While there, update outputs to what is expected with current released binaries and rules. Co-authored-by: Klaus Aehlig <klaus.aehlig@huawei.com> | |||
2025-05-23 | tutorial: Add DWP and ADD_DEBUGFLAGS | Paul Cristian Sarbu | |
...to example export targets and defaults. | |||
2025-05-23 | tutorial debugging: Use ADD_COMPILE_FLAGS | Paul Cristian Sarbu | |
...instead of replacing CFLAGS and CXXFLAGS, thus also fixing a mismatch introduced in c008c07656fff528c80add260397c7c7702aa2a8. | |||
2025-05-23 | Extend tutorial on cross compiling showing how to use ["test", "matrix"] | Klaus Aehlig | |
2025-05-15 | just-mr: support invocation-specific artifacts-to-build logging | Klaus Aehlig | |
It is already supported to ask just-mr (via the rc file) to log for each invocation the artifacts that were built. Add a similar option for the artifacts that were to be built, i.e., for dumping the intensional description of the output artifacts. That information can be used, e.g., to compute the critical path. | |||
2025-05-15 | tutorial invocation logging: include --dump-artifacts | Klaus Aehlig | |
A typical invocation logging would also include a value for "--dump-artifacts". Mention this in the tutorial. | |||
2025-05-14 | tutorial, test: recommend ["test", "suite"] for combining tests | Klaus Aehlig | |
... as this also works together with, e.g., linting. While there, also rerun the examples to get the latest output messages. | |||
2025-05-13 | Tutorial: Update reference to rules-cc | Oliver Reiche | |
2025-05-09 | Add basic introduction to tree overlays | Klaus Aehlig | |
2025-04-23 | Tutorial: mention the possibility to browse individual invocations | Klaus Aehlig | |
2025-04-23 | tutorial: Update DEBUG config variable to map | Paul Cristian Sarbu | |
In preparation for the rule changes, to avoid introducing false positives during future bisections. | |||
2025-04-16 | Add basic tutorial section on invocation logging | Klaus Aehlig | |
... under the advanced chapter of our tutorial. | |||
2025-04-14 | clean up markdown in tutorial and concepts | Klaus Aehlig | |
... and ensure that pandoc processes them correctly. In particular, add an empty line around itemize environments. | |||
2025-03-17 | Extend tutorial to also include other uses of build delegation | Klaus Aehlig | |
2025-03-06 | tutorial: Add chapter on just-lock | Paul Cristian Sarbu | |
Also update the README. | |||
2025-03-06 | tutorial: Consistently use the fmtlib release tag | Paul Cristian Sarbu | |
...instead of using the master branch. | |||
2025-02-18 | tutorial: update tests section | Klaus Aehlig | |
Add the artifacts and outputs of the updated rules, as well as some explanatory remarks. | |||
2025-02-18 | tutorial: update rebuild section | Klaus Aehlig | |
- As we build a binary hello, make it an extension of the hello we had before. - Make the passing of time more explicit. - Add actual output of rerunning the tutorial. | |||
2025-02-17 | tutorial: update hello-world section | Klaus Aehlig | |
As our defaults rule supports flags common for C and C++ use them, especially as our example only uses common flags. | |||
2025-02-17 | tutorial: update reference to rules-cc | Klaus Aehlig | |
2025-02-14 | tutorial, getting started: add the basics of analyse | Klaus Aehlig | |
2025-02-14 | tutorial, getting started: include more idiomatic use of options | Klaus Aehlig | |
... in particular in the case of targets producing precisely one artifact; this better emphasizes the idea that we talk to the tool in terms of targets. While there, also add some clarifying comments. | |||
2025-01-30 | Add basic introduction on how to set up computed roots | Klaus Aehlig | |
2024-10-23 | Update rules reference in tutorial | Klaus Aehlig | |
2024-09-11 | Add a tutorial on setting up linters | Klaus Aehlig | |
2024-09-11 | Update rules-cc commit in tutorial | Klaus Aehlig | |
2024-08-27 | debugging tutorial: Update to include correct toolchain defaults | Paul Cristian Sarbu | |
This is an essential step in the debugging process that was missing in the tutorial. | |||
2024-07-08 | tutorial on tests: set shell defaults | Klaus Aehlig | |
... as they will be used in newer versions of rules-cc to set the path for the test-summary action. | |||
2024-06-26 | proto tutorial: Add section on debugging | Paul Cristian Sarbu | |
This showcases that also generated proto headers will be staged for debugging. | |||
2024-06-26 | Add tutorial to showcase debugging | Paul Cristian Sarbu | |
2024-06-26 | 3rd-party tutorial: Add DEBUG flag for fmtlib export target | Paul Cristian Sarbu | |
This is good practice and it makes it easier to later demonstrate debugging, as the flag value is honored. Also renames the final repos.json example, in order to ensure that any chapters depending on the output of this chapter receives the correct repository description. | |||
2024-06-26 | tutorials: Fix small typos | Paul Cristian Sarbu | |
2024-06-26 | tutorials: Update rules-cc commit | Paul Cristian Sarbu | |
...to version fully supporting debugging. | |||
2024-05-15 | Test tuorial: mention creating a defaults definition for the shell toolchain | Klaus Aehlig | |
... so that the tutorial also works with the latest version of our rules. | |||
2024-04-25 | just serve: Paths in config file should be location objects | Paul Cristian Sarbu | |
Also updates the tests and all relevant documentation accordingly. | |||
2024-04-24 | Add first version of just-serve tutorial | Paul Cristian Sarbu | |
2024-04-23 | tutorial: Update outputs and other improvements | Paul Cristian Sarbu | |
When tutorial docs were changed to showcase running commands with just-mr instead of just, the outputs were not changed. This is now fixed to showcase the results run with current master just-mr (and just), together with other small improvements and fixes. | |||
2024-04-15 | just-execute doc: Small improvements | Paul Cristian Sarbu | |
2024-04-15 | tutorial: Consistent formatting and small fixes | Paul Cristian Sarbu | |
2023-12-19 | tutorial: explain the difference between action graph and the traversed part | Klaus Aehlig | |
When explaining CC tests, the option --request-action-input is used to get hold of the actual test binary. This is the first time in the tutorial where the action graph is larger than the part that that is traversed during the build. Use this oportunity to explain the difference between those concpets as, reportedly, some users got confused about this. | |||
2023-10-24 | just-execute tutorial: recommend statically linked binares | Klaus Aehlig | |
... and point to the repository with machine-readable instructions on how to properly build them. | |||
2023-08-25 | tutorial: hint on `just describe` to list implicit dependencies | Klaus Aehlig | |
2023-08-22 | Update tutorial to use latest version of rules-cc | Klaus Aehlig | |