about summary refs log tree commit diff
diff options
context:
space:
mode:
authorJack Huey <31162821+jackh726@users.noreply.github.com>2021-08-21 20:56:28 -0400
committerGitHub <noreply@github.com>2021-08-21 20:56:28 -0400
commit9e8b143e6aa8af519108cb3375860acdf82ed963 (patch)
treeed87b93df2228d5b9029aa085ceb609086492622
parent8660e3d16bcf212f45f21c83c1b81c67fb417a6f (diff)
parent634244e63ffb9acee22083611af3018404cef7c9 (diff)
downloadrust-9e8b143e6aa8af519108cb3375860acdf82ed963.tar.gz
rust-9e8b143e6aa8af519108cb3375860acdf82ed963.zip
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.
-rw-r--r--RELEASES.md13
1 files changed, 4 insertions, 9 deletions
diff --git a/RELEASES.md b/RELEASES.md
index 1d9ad3160f7..da20d6dc9ea 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -146,18 +146,13 @@ Version 1.54.0 (2021-07-29)
 Language
 -----------------------
 
-- [You can now use macros for values in built-in attribute macros.][83366]
-  While a seemingly minor addition on its own, this enables a lot of
-  powerful functionality when combined correctly. Most notably you can
-  now include external documentation in your crate by writing the following.
+- [You can now use macros for values in some built-in attributes.][83366]
+  This primarily allows you to call macros within the `#[doc]` attribute. For
+  example, to include external documentation in your crate, you can now write
+  the following:
   ```rust
   #![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
   unsized slices) in `const fn`.][85078]