diff options
Diffstat (limited to 'src/libstd')
| -rw-r--r-- | src/libstd/macros.rs | 13 |
1 files changed, 10 insertions, 3 deletions
diff --git a/src/libstd/macros.rs b/src/libstd/macros.rs index c78840bd42b..8946af8af53 100644 --- a/src/libstd/macros.rs +++ b/src/libstd/macros.rs @@ -450,9 +450,16 @@ pub mod builtin { #[macro_export] macro_rules! cfg { ($($cfg:tt)*) => ({ /* compiler built-in */ }) } - /// Parse the current given file as an expression. - /// - /// This is generally a bad idea, because it's going to behave unhygienically. + /// Parse the file provided in the argument as an expression or an + /// item according to the context. This file is located relative + /// to the current file (similarly to how modules are found). + /// + /// Using this macro is often a bad idea, because if the file is + /// parsed as an expression, it is going to be placed in the + /// surrounding code unhygenically. This could result in variables + /// or functions being different from what the file expected if + /// there are variables or functions that have the same name in + /// the current file. /// /// # Examples /// |