Google Git
Sign in
rust / rust-lang / reference / 68a9928ade6b8a034e802e8f5f8f0b96606a3bd6
commit68a9928ade6b8a034e802e8f5f8f0b96606a3bd6[log] [tgz]
authorEric Huss <eric@huss.org>Tue Sep 16 13:15:40 2025 -0700
committerTravis Cross <tc@traviscross.com>Tue Sep 16 23:24:37 2025 +0000
treebb7555ab954c82391ce8b81c92af477aaed06579
parentd01f99118c9ca82e33990e1bb9c230a1e98a3bdd [diff]
Specify the target limits for target-specific ABIs

This specifies the restrictions on which target-specific ABIs are
available. These are defined in `rustc` in [`is_abi_supported`] and
the associated `AbiMap`.

Some of these are currently only implemented as future incompatibly
warnings via `unsupported_calling_conventions`. I'm fine with just not
acknowledging that and saying what the intent is.

This is split off from https://github.com/rust-lang/reference/pull/1948
with the intent of separating out the changes.

[`is_abi_supported`]: https://github.com/rust-lang/rust/blob/eec6bd9d69832f57341c6de6a93fa7b9f47e2111/compiler/rustc_target/src/spec/mod.rs#L2610-L2613

Edited-by: TC
1 file changed
tree: bb7555ab954c82391ce8b81c92af477aaed06579
  1. .cargo/
  2. .github/
  3. docs/
  4. mdbook-spec/
  5. src/
  6. style-check/
  7. theme/
  8. xtask/
  9. .gitattributes
  10. .gitignore
  11. book.toml
  12. CONTRIBUTING.md
  13. LICENSE-APACHE
  14. LICENSE-MIT
  15. README.md
  16. reference.md
  17. rust-toolchain.toml
  18. rustfmt.toml
  19. STYLE.md
  20. triagebot.toml
README.md

The Rust Language Reference

This document is the primary reference for the Rust programming language.

Dependencies

Installing dependencies

First, ensure that you have a recent copy of the nightly Rust compiler installed, as this is needed in order to run the tests:

rustup toolchain install nightly

Now, ensure you have mdbook installed, as this is needed in order to build the Reference:

cargo install --locked mdbook

Building

To build the Reference, first clone the project:

git clone https://github.com/rust-lang/reference.git

(Alternatively, if you don't want to use git, download a ZIP file of the project, extract it using your preferred tool, and rename the top-level directory to reference.)

Now change your current directory to the working directory:

cd reference

To test all of the code examples in the Reference, run:

mdbook test

For authors, consider using the server functionality which supports automatic reload.

To build the Reference locally (in book/) and open it in a web browser, run:

SPEC_RELATIVE=0 mdbook build --open

This will open a browser with a websocket live-link to automatically reload whenever the source is updated.

You can also use mdbook's live webserver option, which will automatically rebuild the book and reload your web browser whenever a source file is modified:

SPEC_RELATIVE=0 mdbook serve --open

SPEC_RELATIVE

The SPEC_RELATIVE=0 environment variable makes links to the standard library go to https://doc.rust-lang.org/ instead of being relative, which is useful when viewing locally since you normally don't have a copy of the standard library.

The published site at https://doc.rust-lang.org/reference/ (or local docs using rustup doc) does not set this, which means it will use relative links which supports offline viewing and links to the correct version (for example, links in https://doc.rust-lang.org/1.81.0/reference/ will stay within the 1.81.0 directory).

SPEC_DENY_WARNINGS

The SPEC_DENY_WARNINGS=1 environment variable will turn all warnings generated by mdbook-spec to errors. This is used in CI to ensure that there aren't any problems with the book content.

SPEC_RUST_ROOT

The SPEC_RUST_ROOT can be used to point to the directory of a checkout of https://github.com/rust-lang/rust. This is used by the test-linking feature so that it can find tests linked to reference rules. If this is not set, then the tests won't be linked.