Merge pull request #25385 from gottesmm/pr-ddab2b9f2264a250da17fb610ac59048c88eca7a

Author: swift-ci

include/swift/SILOptimizer/Utils/CFG.h

@@ -96,8 +96,9 @@ bool rotateLoop(SILLoop *L, DominanceInfo *DT, SILLoopInfo *LI,
                 bool RotateSingleBlockLoops, SILBasicBlock *UpTo,
                 bool ShouldVerify);
 
-/// Splits the basic block before the instruction with an unconditional
-/// branch and updates the dominator tree and loop info.
+/// Splits the basic block before the instruction with an unconditional branch
+/// and updates the dominator tree and loop info. Returns the new, branched to
+/// block that contains the end of \p SplitBeforeInst's block.
 SILBasicBlock *splitBasicBlockAndBranch(SILBuilder &B,
                                         SILInstruction *SplitBeforeInst,
                                         DominanceInfo *DT, SILLoopInfo *LI);