specify lifetime extension of pin! and format_args! arguments

Author: dianne

src/destructors.md

@@ -434,19 +434,22 @@ expression which is one of the following:
   expression], [braced struct][struct expression], or [tuple][tuple expression]
   expression.
 * The arguments to an extending [tuple struct] or [tuple variant] constructor expression.
+* The argument to an extending [`pin!`] or the value arguments to an extending [`format_args!`] [macro invocation] expression.
 * The final expression of any extending [block expression].
 
 So the borrow expressions in `&mut 0`, `(&1, &mut 2)`, and `Some(&mut 3)`
 are all extending expressions. The borrows in `&0 + &1` and `f(&mut 0)` are not.
 
 The operand of any extending borrow expression has its temporary scope
 extended.
+Likewise, the argument to any extending [`pin!`] macro invocation expression and the value arguments to any extending [`format_args!`] macro invocation expression have their temporary scopes extended.
 
 #### Examples
 
 Here are some examples where expressions have extended temporary scopes:
 
 ```rust
+# use std::pin::pin;
 # fn temp() {}
 // The temporary that stores the result of `temp()` lives in the same scope
 // as x in these cases.
@@ -456,6 +459,8 @@ let x = &temp() as &dyn Send;
 # x;
 let x = (&*&temp(),);
 # x;
+let x = pin!(temp());
+# x;
 let x = { [Some(&temp()) ] };
 # x;
 let ref x = temp();
@@ -510,6 +515,7 @@ There is one additional case to be aware of: when a panic reaches a [non-unwindi
 [initialized]: glossary.md#initialized
 [interior mutability]: interior-mutability.md
 [lazy boolean expression]: expressions/operator-expr.md#lazy-boolean-operators
+[macro invocation]: macros.md#macro-invocation
 [non-unwinding ABI boundary]: items/functions.md#unwinding
 [panic]: panic.md
 [place context]: expressions.md#place-expressions-and-value-expressions
@@ -554,3 +560,6 @@ There is one additional case to be aware of: when a panic reaches a [non-unwindi
 [`match`]: expressions/match-expr.md
 [`while let`]: expressions/loop-expr.md#while-let-patterns
 [`while`]: expressions/loop-expr.md#predicate-loops
+
+[`pin!`]: std::pin::pin
+[`format_args!`]: core::format_args