Rollup merge of #88057 - ehuss:releases-doc-macros, r=Mark-Simulacrum

Update RELEASES to clarify attribute macro values.

As noted in #87681, macros do not work with the `#[path]` attribute.  Since the places where macros *can* be used is very limited, I have changed this to just focus on `#[doc]` which is the only attribute where this is really useful.
This commit is contained in:
Jack Huey 2021-08-21 20:56:28 -04:00 committed by GitHub
commit 9e8b143e6a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -146,18 +146,13 @@ Version 1.54.0 (2021-07-29)
Language Language
----------------------- -----------------------
- [You can now use macros for values in built-in attribute macros.][83366] - [You can now use macros for values in some built-in attributes.][83366]
While a seemingly minor addition on its own, this enables a lot of This primarily allows you to call macros within the `#[doc]` attribute. For
powerful functionality when combined correctly. Most notably you can example, to include external documentation in your crate, you can now write
now include external documentation in your crate by writing the following. the following:
```rust ```rust
#![doc = include_str!("README.md")] #![doc = include_str!("README.md")]
``` ```
You can also use this to include auto-generated modules:
```rust
#[path = concat!(env!("OUT_DIR"), "/generated.rs")]
mod generated;
```
- [You can now cast between unsized slice types (and types which contain - [You can now cast between unsized slice types (and types which contain
unsized slices) in `const fn`.][85078] unsized slices) in `const fn`.][85078]