[PATCH] D136968: [RISCV][docs] Add some wording around vendor extensions
Philip Reames via Phabricator via llvm-commits
llvm-commits at lists.llvm.org
Tue Nov 1 09:34:29 PDT 2022
This revision was automatically updated to reflect the committed changes.
Closed by commit rG9395b98ba03e: [RISCV][docs] Add some wording around vendor extensions (authored by reames).
Changed prior to commit:
https://reviews.llvm.org/D136968?vs=472188&id=472333#toc
Repository:
rG LLVM Github Monorepo
CHANGES SINCE LAST ACTION
https://reviews.llvm.org/D136968/new/
https://reviews.llvm.org/D136968
Files:
llvm/docs/RISCVUsage.rst
Index: llvm/docs/RISCVUsage.rst
===================================================================
--- llvm/docs/RISCVUsage.rst
+++ llvm/docs/RISCVUsage.rst
@@ -146,6 +146,18 @@
To use an experimental extension from `clang`, you must add `-menable-experimental-extensions` to the command line, and specify the exact version of the experimental extension you are using. To use an experimental extension with LLVM's internal developer tools (e.g. `llc`, `llvm-objdump`, `llvm-mc`), you must prefix the extension name with `experimental-`. Note that you don't need to specify the version with internal tools, and shouldn't include the `experimental-` prefix with `clang`.
+Vendor Extensions
+=================
+
+Vendor extensions are extensions which are not standardized by RISC-V International, and are instead defined by a hardware vendor. At the moment, LLVM does not support any vendor extensions for RISC-V, but we expect this to change in the future.
+
+The term vendor extension roughly parallels the definition of a `non-standard` extension from Section 1.3 of the Volume I: RISC-V Unprivileged ISA specification. In particular, we expect to eventually accept both `custom` extensions and `non-conforming` extensions.
+
+Inclusion of a vendor extension will be considered on a case by case basis. All proposals should be brought to the bi-weekly RISCV sync calls for discussion. For a general idea of the factors likely to be considered, please see the `Clang documentation <https://clang.llvm.org/get_involved.html>`_.
+
+It is our intention to follow the naming conventions described in `riscv-non-isa/riscv-toolchain-conventions <https://github.com/riscv-non-isa/riscv-toolchain-conventions#conventions-for-vendor-extensions>`_. Exceptions to this naming will need to be strongly motivated.
+
+
Specification Documents
=======================
For ratified specifications, please refer to the `official RISC-V International
-------------- next part --------------
A non-text attachment was scrubbed...
Name: D136968.472333.patch
Type: text/x-patch
Size: 1949 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20221101/09c5caed/attachment-0001.bin>
More information about the llvm-commits
mailing list