Merge pull request swiftlang#30226 from gottesmm/pr-7685cba8a8fe94412c5e6edd32dc419c03252b39

[gardening] Add comments explaining what alloc_stack [dynamic_lifetime] means.

Author: eeckstein

include/swift/SIL/SILInstruction.h

@@ -1444,7 +1444,18 @@ class AllocStackInst final
     }
   }
 
+  /// Set to true that this alloc_stack contains a value whose lifetime can not
+  /// be ascertained from uses.
+  ///
+  /// As an example if an alloc_stack is known to be only conditionally
+  /// initialized.
   void setDynamicLifetime() { dynamicLifetime = true; }
+
+  /// Returns true if the alloc_stack's initialization can not be ascertained
+  /// from uses directly (so should be treated conservatively).
+  ///
+  /// An example of an alloc_stack with dynamic lifetime is an alloc_stack that
+  /// is conditionally initialized.
   bool hasDynamicLifetime() const { return dynamicLifetime; }
 
   /// Return the debug variable information attached to this instruction.