From 2319d62f21e4cdcf4575d1512cb8058dd03fd6b4 Mon Sep 17 00:00:00 2001 From: mlugg Date: Tue, 15 Oct 2024 16:36:10 +0100 Subject: [PATCH] std.builtin.CallingConvention: include exact architecture tags in comments --- lib/std/builtin.zig | 64 ++++++++++++++++++++++----------------------- 1 file changed, 32 insertions(+), 32 deletions(-) diff --git a/lib/std/builtin.zig b/lib/std/builtin.zig index b8e3acaad8..3cb0cd9985 100644 --- a/lib/std/builtin.zig +++ b/lib/std/builtin.zig @@ -256,7 +256,7 @@ pub const CallingConvention = union(enum(u8)) { /// Pointers to inline functions are comptime-only. @"inline", - // Calling conventions for the x86_64 architecture. + // Calling conventions for the `x86_64` architecture. x86_64_sysv: CommonOptions, x86_64_win: CommonOptions, x86_64_regcall_v3_sysv: CommonOptions, @@ -264,7 +264,7 @@ pub const CallingConvention = union(enum(u8)) { x86_64_vectorcall: CommonOptions, x86_64_interrupt: CommonOptions, - // Calling conventions for the x86 architecture. + // Calling conventions for the `x86` architecture. x86_sysv: X86RegparmOptions, x86_win: X86RegparmOptions, x86_stdcall: X86RegparmOptions, @@ -276,14 +276,14 @@ pub const CallingConvention = union(enum(u8)) { x86_vectorcall: CommonOptions, x86_interrupt: CommonOptions, - // Calling conventions for the aarch64 architecture. + // Calling conventions for the `aarch64` and `aarch64_be` architectures. aarch64_aapcs: CommonOptions, aarch64_aapcs_darwin: CommonOptions, aarch64_aapcs_win: CommonOptions, aarch64_vfabi: CommonOptions, aarch64_vfabi_sve: CommonOptions, - // Calling convetions for the arm architecture. + // Calling convetions for the `arm`, `armeb`, `thumb`, and `thumbeb` architectures. /// ARM Procedure Call Standard (obsolete) arm_apcs: CommonOptions, /// ARM Architecture Procedure Call Standard @@ -293,114 +293,114 @@ pub const CallingConvention = union(enum(u8)) { arm_aapcs16_vfp: CommonOptions, arm_interrupt: ArmInterruptOptions, - // Calling conventions for the mips64 architecture. + // Calling conventions for the `mips64` architecture. mips64_n64: CommonOptions, mips64_n32: CommonOptions, mips64_interrupt: MipsInterruptOptions, - // Calling conventions for the mips architecture. + // Calling conventions for the `mips` architecture. mips_o32: CommonOptions, mips_interrupt: MipsInterruptOptions, - // Calling conventions for the riscv64 architecture. + // Calling conventions for the `riscv64` architecture. riscv64_lp64: CommonOptions, riscv64_lp64_v: CommonOptions, riscv64_interrupt: RiscvInterruptOptions, - // Calling conventions for the riscv32 architecture. + // Calling conventions for the `riscv32` architecture. riscv32_ilp32: CommonOptions, riscv32_ilp32_v: CommonOptions, riscv32_interrupt: RiscvInterruptOptions, - // Calling conventions for the sparc64 architecture. + // Calling conventions for the `sparc64` architecture. sparc64_sysv: CommonOptions, - // Calling conventions for the sparc architecture. + // Calling conventions for the `sparc` architecture. sparc_sysv: CommonOptions, - // Calling conventions for the powerpc64 architecture. + // Calling conventions for the `powerpc64` and `powerpc64le` architectures. powerpc64_elf: CommonOptions, powerpc64_elf_altivec: CommonOptions, powerpc64_elf_v2: CommonOptions, - // Calling conventions for the powerpc architecture. + // Calling conventions for the `powerpc` and `powerpcle` architectures. powerpc_sysv: CommonOptions, powerpc_sysv_altivec: CommonOptions, powerpc_aix: CommonOptions, powerpc_aix_altivec: CommonOptions, - /// The standard wasm32/wasm64 calling convention, as specified in the WebAssembly Tool Conventions. + /// The standard `wasm32`/`wasm64` calling convention, as specified in the WebAssembly Tool Conventions. wasm_watc: CommonOptions, - /// The standard ARC calling convention. + /// The standard `arc` calling convention. arc_sysv: CommonOptions, - // Calling conventions for the AVR architecture. + // Calling conventions for the `avr` architecture. avr_gnu, avr_builtin, avr_signal, avr_interrupt, - /// The standard bpf calling convention. + /// The standard `bpfel`/`bpfeb` calling convention. bpf_std: CommonOptions, - // Calling conventions for the csky architecture. + // Calling conventions for the `csky` architecture. csky_sysv: CommonOptions, csky_interrupt: CommonOptions, - // Calling conventions for the hexagon architecture. + // Calling conventions for the `hexagon` architecture. hexagon_sysv: CommonOptions, hexagon_sysv_hvx: CommonOptions, - /// The standard Lanai calling convention. + /// The standard `lanai` calling convention. lanai_sysv: CommonOptions, - /// The standard loongarch64 calling convention. + /// The standard `loongarch64` calling convention. loongarch64_lp64: CommonOptions, - /// The standard loongarch32 calling convention. + /// The standard `loongarch32` calling convention. loongarch32_ilp32: CommonOptions, - // Calling conventions for the m68k architecture. + // Calling conventions for the `m68k` architecture. m68k_sysv: CommonOptions, m68k_gnu: CommonOptions, m68k_rtd: CommonOptions, m68k_interrupt: CommonOptions, - /// The standard MSP430 calling convention. + /// The standard `msp430` calling convention. msp430_eabi: CommonOptions, - /// The standard propeller1 calling convention. + /// The standard `propeller1` calling convention. propeller1_sysv: CommonOptions, - /// The standard propeller1 calling convention. + /// The standard `propeller2` calling convention. propeller2_sysv: CommonOptions, - // Calling conventions for the S390X architecture. + // Calling conventions for the `s390x` architecture. s390x_sysv: CommonOptions, s390x_sysv_vx: CommonOptions, - /// The standard VE calling convention. + /// The standard `ve` calling convention. ve_sysv: CommonOptions, - // Calling conventions for the xCORE architecture. + // Calling conventions for the `xcore` architecture. xcore_xs1: CommonOptions, xcore_xs2: CommonOptions, - // Calling conventions for the Xtensa architecture. + // Calling conventions for the `xtensa` architecture. xtensa_call0: CommonOptions, xtensa_windowed: CommonOptions, - // Calling conventions for the AMDGCN architecture. + // Calling conventions for the `amdgcn` architecture. amdgcn_device: CommonOptions, amdgcn_kernel, amdgcn_cs: CommonOptions, - // Calling conventions for the NVPTX architecture. + // Calling conventions for the `nvptx` architecture. nvptx_device, nvptx_kernel, - // Calling conventions for SPIR-V kernels and shaders. + // Calling conventions for kernels and shaders on the `spirv`, `spirv32`, and `spirv64` architectures. spirv_device, spirv_kernel, spirv_fragment,