From 3660a790fbfeaadde80e0846b91005465f384b1e Mon Sep 17 00:00:00 2001 From: christopherdumas Date: Sun, 11 Sep 2016 14:42:22 -0700 Subject: [PATCH] Fixed issue #36387 --- src/libstd/macros.rs | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/src/libstd/macros.rs b/src/libstd/macros.rs index 6f0f6ecab5ba8..13083c71dd31f 100644 --- a/src/libstd/macros.rs +++ b/src/libstd/macros.rs @@ -444,9 +444,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 ///