Skip to content

Conversation

@kkysen
Copy link
Contributor

@kkysen kkysen commented Nov 12, 2025

This updates the README.md, docs/, and manual/ to

  • re-add c2rust refactor now that it's been resurrected.
  • remove known limitations that have now been fixed (inline assembly, C11 atomics, packed structs).
  • remove references to things that have been removed (cross-checks, Docker, Azure CI, rustfmt-preview, Lua scripting).
  • recommend godbolt.org instead of c2rust.com, as it's actually up-to-date and much nicer to use.
  • recommend bear over intercept-build, as it's much more up-to-date and not Linux-only anymore.
  • update installation instructions to use --locked, which we get a lot of issues about.
  • update all the even older nightly references to nightly-2022-08-08, except for the generated nightly-2023-04-15, which is on purpose and up-to-date.
  • update everything else to use uv, too (test_translator.py and c2rust-testsuite/test.py already were, our main test scripts).

It doesn't, however,

  • update c2rust.com/manual, as I'm not sure how to do that. But the README.md does now warn that c2rust.com/manual is currently very out-of-date and to refer to the in-tree sources instead.
  • touch any of manual/c2rust-refactor/doc/{ldoc.css, scripting_api.html}.
  • update most dependencies. Many aren't needed or used anymore, or use the wrong versions, but determining that needs more CI testing (our main source of truth).

This recommends `bear` over `intercept-build` instead of the opposite,
as it's more robust now, not Linux-only, and more up-to-date.

Also, running it on clean builds is mentioned now.
`c2rust-testsuite/test.py` already is set up to use `uv`,
but we also need a `uv tool install scan-build` for `intercept-build`
(which is what was left in `requirements.txt`).
@kkysen kkysen force-pushed the kkysen/update-readme-docs-manual branch from f311083 to 87eebdf Compare November 16, 2025 00:46
@kkysen kkysen requested a review from ahomescu November 16, 2025 00:47
@kkysen kkysen merged commit c2aa5e6 into master Nov 16, 2025
5 checks passed
@kkysen kkysen deleted the kkysen/update-readme-docs-manual branch November 16, 2025 01:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants