Skip to content

Commit d0d0612

Browse files
committed
Revise wording on explicit extern ABI change
1 parent 12092cd commit d0d0612

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

src/items/external-blocks.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -102,15 +102,17 @@ The `extern` keyword can be followed by an optional <abbr title="application bin
102102

103103
> [!EXAMPLE]
104104
> ```rust
105-
> // Interface to the Windows API
106-
> unsafe extern "system" { }
105+
> // Interface to the Windows API.
106+
> unsafe extern "system" { /* ... */ }
107107
> ```
108108
109109
r[items.extern.abi.default]
110110
If the ABI string is not specified, it defaults to `"C"`.
111111
112112
> [!NOTE]
113-
> It is recommended to always specify the ABI to make it clear which ABI is used. Future versions of Rust may make this a requirement, see [#134986](https://github.com/rust-lang/rust/issues/134986).
113+
> The `extern` syntax without an explicit ABI is being phased out, so it's better to always write the ABI explicitly.
114+
>
115+
> For more details, see [Rust issue #134986](https://github.com/rust-lang/rust/issues/134986).
114116
115117
r[items.extern.abi.standard]
116118
The following ABI strings are supported on all platforms:

0 commit comments

Comments
 (0)