@@ -1312,7 +1312,7 @@ pub(crate) mod builtin {
1312
1312
/* compiler built-in */
1313
1313
} ;
1314
1314
}
1315
-
1315
+
1316
1316
/// Parses a file as an expression or an item according to the context.
1317
1317
///
1318
1318
/// <div class="example-wrap" style="display:inline-block">
@@ -1328,19 +1328,19 @@ pub(crate) mod builtin {
1328
1328
///
1329
1329
/// </pre>
1330
1330
/// </div>
1331
- ///
1331
+ ///
1332
1332
/// If the included file is parsed as an expression, it is placed in the surrounding code
1333
1333
/// [unhygienically](https://doc.rust-lang.org/reference/macros-by-example.html#hygiene). This
1334
1334
/// could result in variables or functions being different from what the file expected if there
1335
1335
/// are variables or functions that have the same name in the current file.
1336
- ///
1336
+ ///
1337
1337
/// The included file is located relative to the current file (similarly to how modules are
1338
1338
/// found). The provided path is interpreted in a platform-specific way at compile time. So,
1339
1339
/// for instance, an invocation with a Windows path containing backslashes `\` would not
1340
1340
/// compile correctly on Unix.
1341
1341
///
1342
1342
/// # Uses
1343
- ///
1343
+ ///
1344
1344
/// The `include!` macro is primarily used for two purposes. It is used to include
1345
1345
/// documentation that is written in a separate file and it is used to include [build artifacts
1346
1346
/// usually as a result from the `build.rs`
@@ -1351,31 +1351,31 @@ pub(crate) mod builtin {
1351
1351
/// use the [`include_str`] macro as `#![doc = include_str!("...")]` (at the module level) or
1352
1352
/// `#[doc = include_str!("...")]` (at the item level) to include documentation from a plain
1353
1353
/// text or markdown file.
1354
- ///
1354
+ ///
1355
1355
/// # Examples
1356
- ///
1356
+ ///
1357
1357
/// Assume there are two files in the same directory with the following contents:
1358
- ///
1358
+ ///
1359
1359
/// File 'monkeys.in':
1360
- ///
1360
+ ///
1361
1361
/// ```ignore (only-for-syntax-highlight)
1362
1362
/// ['🙈', '🙊', '🙉']
1363
1363
/// .iter()
1364
1364
/// .cycle()
1365
1365
/// .take(6)
1366
1366
/// .collect::<String>()
1367
1367
/// ```
1368
- ///
1368
+ ///
1369
1369
/// File 'main.rs':
1370
- ///
1370
+ ///
1371
1371
/// ```ignore (cannot-doctest-external-file-dependency)
1372
1372
/// fn main() {
1373
1373
/// let my_string = include!("monkeys.in");
1374
1374
/// assert_eq!("🙈🙊🙉🙈🙊🙉", my_string);
1375
1375
/// println!("{my_string}");
1376
1376
/// }
1377
1377
/// ```
1378
- ///
1378
+ ///
1379
1379
/// Compiling 'main.rs' and running the resulting binary will print
1380
1380
/// "🙈🙊🙉🙈🙊🙉".
1381
1381
#[ stable( feature = "rust1" , since = "1.0.0" ) ]
0 commit comments