[llvm-branch-commits] [openmp] [OpenMP][docs] Finish MyST migration for OpenMP docs (PR #222194)

[Michael Kruse via llvm-branch-commits]

================
@@ -1,186 +1,234 @@
-OpenMP Command-Line Argument Reference
-======================================
-Welcome to the OpenMP in LLVM command line argument reference. The content is 
-not a complete list of arguments but includes the essential command-line 
-arguments you may need when compiling and linking OpenMP. 
-Section :ref:`general_command_line_arguments` lists OpenMP command line options 
-for multicore programming while  :ref:`offload_command_line_arguments` lists 
+:::{program} clang
+:::
+
+# OpenMP Command-Line Argument Reference
+
+Welcome to the OpenMP in LLVM command line argument reference. The content is
+not a complete list of arguments but includes the essential command-line
+arguments you may need when compiling and linking OpenMP.
+Section {ref}`general_command_line_arguments` lists OpenMP command line options
+for multicore programming while {ref}`offload_command_line_arguments` lists
 options relevant to OpenMP target offloading.
 
-.. _general_command_line_arguments:
+(general_command_line_arguments)=
+
+## OpenMP Command-Line Arguments
 
-OpenMP Command-Line Arguments
------------------------------
+(fopenmp)=
 
-``-fopenmp``
-^^^^^^^^^^^^
-Enable the OpenMP compilation toolchain. The compiler will parse OpenMP 
+:::{option} -fopenmp
+Enable the OpenMP compilation toolchain. The compiler will parse OpenMP
 compiler directives and generate parallel code.
+:::
 
-``-fopenmp-extensions``
-^^^^^^^^^^^^^^^^^^^^^^^
-Enable all ``Clang`` extensions for OpenMP directives and clauses. A list of 
-current extensions and their implementation status can be found on the 
-`support <https://clang.llvm.org/docs/OpenMPSupport.html#openmp-extensions>`_ 
+(fopenmp-extensions)=
+
+:::{option} -fopenmp-extensions
+Enable all `Clang` extensions for OpenMP directives and clauses. A list of
+current extensions and their implementation status can be found on the
+[support](https://clang.llvm.org/docs/OpenMPSupport.html#openmp-extensions)
 page.
+:::
+
+(fopenmp-simd)=
 
-``-fopenmp-simd``
-^^^^^^^^^^^^^^^^^
-This option enables OpenMP only for single instruction, multiple data 
+:::{option} -fopenmp-simd
+This option enables OpenMP only for single instruction, multiple data
 (SIMD) constructs.
+:::
+
+(static-openmp)=
 
-``-static-openmp``
-^^^^^^^^^^^^^^^^^^
+:::{option} -static-openmp
 Use the static OpenMP host runtime while linking.
+:::
+
+(fopenmp-version-arg)=
+
+:::{option} -fopenmp-version=<arg>
+Set the OpenMP version to a specific version `<arg>` of the OpenMP standard.
+For example, you may use `-fopenmp-version=45` to select version 4.5 of
+the OpenMP standard. The default value is `-fopenmp-version=51` for `Clang`.
+:::
+
+(offload_command_line_arguments)=
+
+## Offloading Specific Command-Line Arguments
+
+(fopenmp-targets)=
+
+:::{option} -fopenmp-targets
+Specify which OpenMP offloading targets should be supported. For example, you
+may specify `-fopenmp-targets=amdgcn-amd-amdhsa,nvptx64`. This option is
+often optional when {ref}`--offload-arch <offload_arch>` is provided.
----------------
Meinersbur wrote:

[nit] this renders as 
<img width="134" height="42" alt="Image" src="https://github.com/user-attachments/assets/b570d331-4a89-4f21-991f-ac901e2f25cf" />
with a single en-dash, not double-dash, because of smark quote. LLVM suggests
```
`{option}\`--offload-arch
```
here

https://github.com/llvm/llvm-project/pull/222194