rust-lang / reference

The Rust Reference
https://doc.rust-lang.org/nightly/reference/
Apache License 2.0
1.22k stars 476 forks source link

Explain what the `fn` is an "ABI" and what equivalencies we guarantee #1623

Open workingjubilee opened 1 day ago

workingjubilee commented 1 day ago

Documentation for this is sort of awkwardly scattered around std docs, the Reference, the Rustonomicon, and the UCG (some of which is more aspirational than actual, for note!), we should sit down and actually document it all somewhere. Probably a new or massively-expanded section of the Reference.

Some notes on major things to make sure we've gotten down into roughly the same place:

workingjubilee commented 1 day ago

@chorman0773 you'll fill in the list of things I missed, I trust

chorman0773 commented 1 day ago

1545 contains the ABI equivalence rules.

workingjubilee commented 1 day ago

Cool!