rusticl: add README file
authorKarol Herbst <kherbst@redhat.com>
Sat, 10 Sep 2022 13:32:45 +0000 (15:32 +0200)
committerMarge Bot <emma+marge@anholt.net>
Mon, 12 Sep 2022 05:58:13 +0000 (05:58 +0000)
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/15439>

src/gallium/frontends/rusticl/README.md [new file with mode: 0644]

diff --git a/src/gallium/frontends/rusticl/README.md b/src/gallium/frontends/rusticl/README.md
new file mode 100644 (file)
index 0000000..4cf82cb
--- /dev/null
@@ -0,0 +1,15 @@
+# Rusticl
+
+The easiest way to build Rusticl is by either installing `rustc`, `rustfmt` and `bindgen` from your distribution or to simply use rustup. Just make sure that the `rustfmt` and `bindgen` components are installed. Then simply add `-Dgallium-rusticl=true -Dllvm=enabled -Drust_std=2021` to your build options.
+
+Most of the code related to Mesa's C code lives inside `/mesa`, with the occasional use of enums, structs or constants through the code base.
+
+If you need help ping `karolherbst` either in `#dri-devel` or `#rusticl` on OFTC.
+
+Also, make sure that before submitting code to verify the formatting is in order. That can easily be done via `git ls-files */{lib,app}.rs | xargs rustfmt`
+
+When submitting Merge Requests or filing bugs related to Rusticl, make sure to add the `Rusticl` label so people subscribed to that Label get pinged.
+
+## Known issues
+
+One issue you might come across is, that the Rust edition meson sets is not right. This is a known [meson bug](https://github.com/mesonbuild/meson/issues/10664) and in order to fix it, simply run `meson configure $your_build_dir -Drust_std=2021`