Skip to content

Commit 45de0c5

Browse files
committed
Convert ABI "details" links to lists
For each of the ABIs, we have outbound links to documents with more details. For most of these, we display the URL, since these URLs are short and readable enough that it's probably more informative to just show them as compared to trying to describe the document. However, the URLs are still long enough that they look better as list items, so let's switch to doing it that way.
1 parent 5ef9f4f commit 45de0c5

File tree

1 file changed

+27
-7
lines changed

1 file changed

+27
-7
lines changed

src/items/external-blocks.md

Lines changed: 27 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -141,15 +141,21 @@ r[items.extern.abi.cdecl]
141141
* Corresponds to MSVC's `__cdecl` and GCC and clang's `__attribute__((cdecl))`.
142142
143143
> [!NOTE]
144-
> See <https://learn.microsoft.com/en-us/cpp/cpp/cdecl> and <https://en.wikipedia.org/wiki/X86_calling_conventions#cdecl> for more information.
144+
> For details, see:
145+
>
146+
> - <https://learn.microsoft.com/en-us/cpp/cpp/cdecl>
147+
> - <https://en.wikipedia.org/wiki/X86_calling_conventions#cdecl>
145148
146149
r[items.extern.abi.stdcall]
147150
* `unsafe extern "stdcall"` --- The calling convention typically used by the [Win32 API] on x86_32.
148151
* Only available on x86_32 targets.
149152
* Corresponds to MSVC's `__stdcall` and GCC and clang's `__attribute__((stdcall))`.
150153
151154
> [!NOTE]
152-
> See <https://learn.microsoft.com/en-us/cpp/cpp/stdcall> and <https://en.wikipedia.org/wiki/X86_calling_conventions#stdcall> for more information.
155+
> For details, see:
156+
>
157+
> - <https://learn.microsoft.com/en-us/cpp/cpp/stdcall>
158+
> - <https://en.wikipedia.org/wiki/X86_calling_conventions#stdcall>
153159
154160
r[items.extern.abi.win64]
155161
* `unsafe extern "win64"` --- The Windows x64 ABI.
@@ -158,7 +164,10 @@ r[items.extern.abi.win64]
158164
* Corresponds to GCC and clang's `__attribute__((ms_abi))`.
159165
160166
> [!NOTE]
161-
> See <https://learn.microsoft.com/en-us/cpp/build/x64-software-conventions> and <https://en.wikipedia.org/wiki/X86_calling_conventions#Microsoft_x64_calling_convention> for more information.
167+
> For details, see:
168+
>
169+
> - <https://learn.microsoft.com/en-us/cpp/build/x64-software-conventions>
170+
> - <https://en.wikipedia.org/wiki/X86_calling_conventions#Microsoft_x64_calling_convention>
162171
163172
r[items.extern.abi.sysv64]
164173
* `unsafe extern "sysv64"` --- The System V ABI.
@@ -167,7 +176,10 @@ r[items.extern.abi.sysv64]
167176
* Corresponds to GCC and clang's `__attribute__((sysv_abi))`.
168177
169178
> [!NOTE]
170-
> See <https://wiki.osdev.org/System_V_ABI> or <https://en.wikipedia.org/wiki/X86_calling_conventions#System_V_AMD64_ABI> for more information.
179+
> For details, see:
180+
>
181+
> - <https://wiki.osdev.org/System_V_ABI>
182+
> - <https://en.wikipedia.org/wiki/X86_calling_conventions#System_V_AMD64_ABI>
171183
172184
r[items.extern.abi.aapcs]
173185
* `unsafe extern "aapcs"` --- The soft-float ABI for ARM.
@@ -176,23 +188,31 @@ r[items.extern.abi.aapcs]
176188
* Corresponds to clang's `__attribute__((pcs("aapcs")))`.
177189
178190
> [!NOTE]
179-
> See [Arm Procedure Call Standard](https://developer.arm.com/documentation/107656/0101/Getting-started-with-Armv8-M-based-systems/Procedure-Call-Standard-for-Arm-Architecture--AAPCS-) for more information.
191+
> For details, see:
192+
>
193+
> - [Arm Procedure Call Standard](https://developer.arm.com/documentation/107656/0101/Getting-started-with-Armv8-M-based-systems/Procedure-Call-Standard-for-Arm-Architecture--AAPCS-)
180194
181195
r[items.extern.abi.fastcall]
182196
* `unsafe extern "fastcall"` --- A "fast" variant of stdcall that passes some arguments in registers.
183197
* Only available on x86_32 targets.
184198
* Corresponds to MSVC's `__fastcall` and GCC and clang's `__attribute__((fastcall))`.
185199
186200
> [!NOTE]
187-
> See <https://learn.microsoft.com/en-us/cpp/cpp/fastcall> and <https://en.wikipedia.org/wiki/X86_calling_conventions#Microsoft_fastcall> for more information.
201+
> For details, see:
202+
>
203+
> - <https://learn.microsoft.com/en-us/cpp/cpp/fastcall>
204+
> - <https://en.wikipedia.org/wiki/X86_calling_conventions#Microsoft_fastcall>
188205
189206
r[items.extern.abi.thiscall]
190207
* `unsafe extern "thiscall"` --- The calling convention typically used on C++ class member functions on x86_32 MSVC.
191208
* Only available on x86_32 targets.
192209
* Corresponds to MSVC's `__thiscall` and GCC and clang's `__attribute__((thiscall))`.
193210
194211
> [!NOTE]
195-
> See <https://en.wikipedia.org/wiki/X86_calling_conventions#thiscall> and <https://learn.microsoft.com/en-us/cpp/cpp/thiscall> for more information.
212+
> For details, see:
213+
>
214+
> - <https://en.wikipedia.org/wiki/X86_calling_conventions#thiscall>
215+
> - <https://learn.microsoft.com/en-us/cpp/cpp/thiscall>
196216
197217
r[items.extern.abi.efiapi]
198218
* `unsafe extern "efiapi"` --- The ABI used for [UEFI] functions.

0 commit comments

Comments
 (0)