[llvm-branch-commits] [clang] [docs] Finish MyST migration for selected Clang docs (PR #214617)
Justin Bogner via llvm-branch-commits
llvm-branch-commits at lists.llvm.org
Fri Aug 7 16:47:48 PDT 2026
================
@@ -1,36 +1,33 @@
-===================
-HLSL Function Calls
-===================
+# HLSL Function Calls
-.. contents::
- :local:
+```{contents}
+:local: true
+```
-Introduction
-============
+## Introduction
This document describes the design and implementation of HLSL's function call
semantics in Clang. This includes details related to argument conversion and
parameter lifetimes.
This document does not seek to serve as official documentation for HLSL's
call semantics, but does provide an overview to assist a reader. The
-authoritative documentation for HLSL's language semantics is the `draft language
-specification <https://microsoft.github.io/hlsl-specs/specs/hlsl.pdf>`_.
+authoritative documentation for HLSL's language semantics is the [draft language
+specification](https://microsoft.github.io/hlsl-specs/specs/hlsl.pdf).
-Argument Semantics
-==================
+## Argument Semantics
In HLSL, all function arguments are passed by value in and out of functions.
-HLSL has 3 keywords which denote the parameter semantics (``in``, ``out`` and
-``inout``). In a function declaration a parameter may be annotated any of the
+HLSL has 3 keywords which denote the parameter semantics (`in`, `out` and
+`inout`). In a function declaration a parameter may be annotated any of the
following ways:
-#. <no parameter annotation> - denotes input
-#. ``in`` - denotes input
-#. ``out`` - denotes output
-#. ``in out`` - denotes input and output
-#. ``out in`` - denotes input and output
-#. ``inout`` - denotes input and output
+1. `<no parameter annotation>` - denotes input
----------------
bogner wrote:
Did the tool do this or was it an editorial choice? That is, \<no parameter annotation\> was previously regular text and now it's monospaced. Either way looks totally reasonable, so no actual problem here, but I am curious. I would've expected `\<no parameter annotation\>`.
https://github.com/llvm/llvm-project/pull/214617
More information about the llvm-branch-commits
mailing list