remove `@noInlineCall` from zig

1 files changed, 26 insertions, 0 deletions

diff --git a/lib/std/builtin.zig b/lib/std/builtin.zig
index 791d46bc34..8ac58ad2f4 100644
--- a/lib/std/builtin.zig
+++ b/lib/std/builtin.zig
@@ -379,13 +379,39 @@ pub const CallOptions = struct {
     stack: ?[]align(std.Target.stack_align) u8 = null,
 
     pub const Modifier = enum {
+        /// Equivalent to function call syntax.
         auto,
+
+        /// Asserts that the function call will not suspend. This allows a
+        /// non-async function to call an async function.
         no_async,
+
+        /// The function call will return an async function frame instead of
+        /// the function's result, which is expected to then be awaited.
+        /// This is equivalent to using the `async` keyword in front of function
+        /// call syntax.
         async_call,
+
+        /// Prevents tail call optimization. This guarantees that the return
+        /// address will point to the callsite, as opposed to the callsite's
+        /// callsite. If the call is otherwise required to be tail-called
+        /// or inlined, a compile error is emitted instead.
         never_tail,
+
+        /// Guarantees that the call will not be inlined. If the call is
+        /// otherwise required to be inlined, a compile error is emitted instead.
         never_inline,
+
+        /// Guarantees that the call will be generated with tail call optimization.
+        /// If this is not possible, a compile error is emitted instead.
         always_tail,
+
+        /// Guarantees that the call will inlined at the callsite.
+        /// If this is not possible, a compile error is emitted instead.
         always_inline,
+
+        /// Evaluates the call at compile-time. If the call cannot be completed at
+        /// compile-time, a compile error is emitted instead.
         compile_time,
     };
 };