From 1df30b01ff151bbb5718270e49ca67b5e45e048d Mon Sep 17 00:00:00 2001 From: norablackcat Date: Tue, 16 May 2023 05:18:45 -0600 Subject: [PATCH] docs/rusticl: add Contributing section Part-of: --- docs/envvars.rst | 2 ++ docs/rusticl.rst | 20 +++++++++++++++++--- 2 files changed, 19 insertions(+), 3 deletions(-) diff --git a/docs/envvars.rst b/docs/envvars.rst index 9ed93749027..5b7352113a1 100644 --- a/docs/envvars.rst +++ b/docs/envvars.rst @@ -898,6 +898,8 @@ Clover environment variables allows specifying additional linker options. Specified options are appended after the options set by the OpenCL program in ``clLinkProgram``. + +.. _rusticl-env-var: Rusticl environment variables ----------------------------- diff --git a/docs/rusticl.rst b/docs/rusticl.rst index 9217fc766af..e82fa8debd6 100644 --- a/docs/rusticl.rst +++ b/docs/rusticl.rst @@ -33,9 +33,23 @@ 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`` +Contributing +------------ + +The minimum configuration you need to start developing with rust +is ``RUSTC=clippy-driver meson configure -Dgallium-rusticl=true +-Dllvm=enabled -Drust_std=2021``. In addition you probably want to enable +any device drivers on your platform. Some device drivers as well as some +features are locked behind flags during runtime. See +:ref:`Rusticl environment variables ` for +more info. + +All patches that are potentially conformance breaking and also patches +that add new features should be ran against the appropriate conformance +tests. + +Also, make sure the formatting is in order before submitting code. 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