This is an example of documentation generated by ZigDoc, an alternative to Zig's built-in Auto Doc feature. See also examples in other modes/formats. The project being documented here (as the example) is the Zig standard library. Public Enum
CallModifier
Public Enum
std.lang.CallModifier
pubconstCallModifier = enum
This data structure is used by the Zig language code generation and therefore must be kept in sync with the compiler implementation.
pubconstCallModifier = enum {
/// Equivalent to function call syntax.auto,
/// 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,
/// Asserts that the function call will not suspend. This allows a/// non-async function to call an async function.no_suspend,
/// 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 be 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,
}
This data structure is used by the Zig language code generation and therefore must be kept in sync with the compiler implementation.