Merge pull request swiftlang#21363 from gottesmm/pr-eb302f1196c943be913dfde41bf571754efa96c8

Author: swift-ci

lib/SILOptimizer/Mandatory/SemanticARCOpts.cpp

@@ -32,6 +32,10 @@ STATISTIC(NumEliminatedInsts, "number of removed instructions");
 //                                  Utility
 //===----------------------------------------------------------------------===//
 
+/// Return true if v only has invalidating uses that are destroy_value.
+///
+/// Semantically this implies that a value is never passed off as +1 to memory
+/// or another function implying it can be used everywhere at +0.
 static bool isConsumed(SILValue v,
                        SmallVectorImpl<DestroyValueInst *> &destroys) {
   assert(v.getOwnershipKind() == ValueOwnershipKind::Owned);