rust-lang / reference

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

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

Open workingjubilee opened 2 months ago

workingjubilee commented 2 months 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 2 months ago

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

chorman0773 commented 2 months ago

1545 contains the ABI equivalence rules.

workingjubilee commented 2 months ago

Cool!