Merge pull request #2127 from fmease/upd-include-shebang

Update note about shebang removal in `include`d files

Author: ehuss

src/input-format.md

@@ -54,14 +54,20 @@ fn main() {
 r[input.shebang.inner-attribute]
 As an exception, if the `#!` characters are followed (ignoring intervening [comments] or [whitespace]) by a `[` token, nothing is removed. This prevents an [inner attribute] at the start of a source file being removed.
 
-> [!NOTE]
-> The standard library [`include!`] macro applies byte order mark removal, CRLF normalization, and shebang removal to the file it reads. The [`include_str!`] and [`include_bytes!`] macros do not.
-
 r[input.tokenization]
 ## Tokenization
 
 The resulting sequence of characters is then converted into tokens as described in the remainder of this chapter.
 
+> [!NOTE]
+> The standard library [`include!`] macro applies the following transformations to the file it reads:
+>
+> - Byte order mark removal.
+> - CRLF normalization.
+> - Shebang removal when invoked in an item context (as opposed to expression or statement contexts).
+>
+> The [`include_str!`] and [`include_bytes!`] macros do not apply these transformations.
+
 [inner attribute]: attributes.md
 [BYTE ORDER MARK]: https://en.wikipedia.org/wiki/Byte_order_mark#UTF-8
 [comments]: comments.md