lix/doc/manual
Jade Lovelace 3daeeaefb1 build: implement clang-tidy using our plugin
The principle of this is that you can either externally build it with
Nix (actual implementation will be in a future commit), or it can be
built with meson if the Nix one is not passed in.

The idea I have is that dev shells don't receive the one from Nix to
avoid having to build it, but CI can use the one from Nix and save some
gratuitous rebuilds.

The design of this is that you can run `ninja -C build clang-tidy` and
it will simply correctly clang-tidy the codebase in spite of PCH
bullshit caused by the cc-wrapper.

This is a truly horrendous number of hacks in a ball, caused by bugs in
several pieces of software, and I am not even getting started.

I don't consider this to fix the clang-tidy issue filing, since we still
have a fair number of issues to fix even on the existing minimal
configuration, and I have not yet implemented it in CI. Realistically we
will need to do something like https://github.com/Ericsson/codechecker
to be able to silence warnings without physically touching the code, or
at least *diff* reports between versions.

Also, the run-clang-tidy output design is rather atrocious and must
not be inflicted upon anyone I have respect for, since it buries the
diagnostics in a pile of invocation logs. We would do really well to
integrate with the Gerrit SARIF stuff so we can dump the reports on
people in a user-friendly manner.

Related: https://git.lix.systems/lix-project/lix/issues/147

Change-Id: Ifefe533f3b56874795de231667046b2da6ff2461
2024-08-04 20:41:19 -07:00
..
rl-next build: implement clang-tidy using our plugin 2024-08-04 20:41:19 -07:00
src Fixup a bunch of references to nixos.org manuals 2024-07-18 19:27:33 +00:00
theme Add pre-commit checks 2024-03-29 22:57:40 -07:00
anchors.jq Add pre-commit checks 2024-03-29 22:57:40 -07:00
book.toml docs: enable non-default TOC folding 2024-05-30 00:23:01 +00:00
change-authors.yml Merge "nix flake show: add the description if it exists" into main 2024-08-02 07:56:06 +00:00
custom.css disallow selecting shell prompt in code samples 2022-12-05 11:01:46 +01:00
generate-builtin-constants.nix Format Nix code with nixfmt 2024-04-08 13:00:00 -07:00
generate-builtins.nix Format Nix code with nixfmt 2024-04-08 13:00:00 -07:00
generate-deps.py docs: redo content generation for mdbook and manual 2024-04-11 13:32:06 +00:00
generate-manpage.nix docs: don't compute SUMMARY.md during build 2024-04-09 02:09:36 +00:00
generate-xp-features-shortlist.nix Format Nix code with nixfmt 2024-04-08 13:00:00 -07:00
generate-xp-features.nix Format Nix code with nixfmt 2024-04-08 13:00:00 -07:00
json-to-tree.py docs: generalize manpage generation script as json-to-tree.py 2024-04-10 15:04:34 +02:00
meson.build build: correctly propagate changes to Lix source to manual 2024-06-16 03:43:17 +00:00
process-includes.sh change shebangs of all .sh scripts to bash 2024-06-24 14:00:43 -07:00
quote-literals.xsl Generate release notes again 2014-03-12 14:24:29 +01:00
rclone.conf doc: add a script to upload the nightly manual manually 2024-05-14 14:28:01 -07:00
redirects.js libstore/build: always enable seccomp filtering and no-new-privileges 2024-05-24 21:19:29 +00:00
render-manpage.sh change shebangs of all .sh scripts to bash 2024-06-24 14:00:43 -07:00
substitute.py docs: redo content generation for mdbook and manual 2024-04-11 13:32:06 +00:00
utils.nix Format Nix code with nixfmt 2024-04-08 13:00:00 -07:00