Introduction - The Rust Edition Guide

1. Introduction
2. 1. What are editions?
3. 1. 1.1. Creating a new project
   2. 1.2. Transitioning an existing project to a new edition
   3. 1.3. Advanced migrations
4. 2. Rust 2015
5. 3. Rust 2018
6. 1. 3.1. Path and module system changes
   2. 3.2. Anonymous trait function parameters deprecated
   3. 3.3. New keywords
   4. 3.4. Method dispatch for raw pointers to inference variables
   5. 3.5. Cargo changes
7. 4. Rust 2021
8. 1. 4.1. Additions to the prelude
   2. 4.2. Default Cargo feature resolver
   3. 4.3. IntoIterator for arrays
   4. 4.4. Disjoint capture in closures
   5. 4.5. Panic macro consistency
   6. 4.6. Reserved syntax
   7. 4.7. Raw lifetimes
   8. 4.8. Warnings promoted to errors
   9. 4.9. Or patterns in macro-rules
   10. 4.10. C-string literals
9. 5. Rust 2024
10. 1. 5.1. Language
       2. 1. 5.1.1. RPIT lifetime capture rules
    2. 5.1.2. if let temporary scope
    3. 5.1.3. Tail expression temporary scope
    4. 5.1.4. Match ergonomics reservations
    5. 5.1.5. Unsafe extern blocks
    6. 5.1.6. Unsafe attributes
    7. 5.1.7. unsafe_op_in_unsafe_fn warning
    8. 5.1.8. Disallow references to static mut
    9. 5.1.9. Never type fallback change
    10. 5.1.10. Macro fragment specifiers
    11. 5.1.11. Missing macro fragment specifiers
    12. 5.1.12. gen keyword
    13. 5.1.13. Reserved syntax 3. 5.2. Standard library 4. 1. 5.2.1. Changes to the prelude
    14. 5.2.2. Add IntoIterator for Box<[T]>
    15. 5.2.3. Newly unsafe functions 5. 5.3. Cargo 6. 1. 5.3.1. Cargo: Rust-version aware resolver
    16. 5.3.2. Cargo: Table and key name consistency
    17. 5.3.3. Cargo: Reject unused inherited default-features 7. 5.4. Rustdoc 8. 1. 5.4.1. Rustdoc combined tests
    18. 5.4.2. Rustdoc nested include! change 9. 5.5. Rustfmt 10. 1. 5.5.1. Rustfmt: Style edition
    19. 5.5.2. Rustfmt: Formatting fixes
    20. 5.5.3. Rustfmt: Raw identifier sorting
    21. 5.5.4. Rustfmt: Version sorting

The Rust Edition Guide

Introduction

Welcome to The Rust Edition Guide! "Editions" are Rust's way of introducing changes into the language that would not otherwise be backwards compatible.

In this guide, we'll discuss:

• What editions are
• Which changes are contained in each edition
• How to migrate your code from one edition to another