[llvm-branch-commits] [llvm] [ReleaseNotes][RemoveDIs] Add release note for deprecated insertion methods (PR #127493)

[Jeremy Morse via llvm-branch-commits]

================
@@ -116,6 +116,8 @@ Changes to the LLVM IR
 Changes to LLVM infrastructure
 ------------------------------
 
+ * Several methods that use Instruction pointers as insertion positions (moveBefore, getFirstNonPHI) have been deprecated in favour of overloads and variants that use `BasicBlock::iterator`s instead. The instruction-flavoured methods will be removed in a future release. This work is part of the [RemoveDIs](https://llvm.org/docs/RemoveDIsDebugInfo.html) project, the documentation for which contains instructions for updating call-sites using the deprecated methods.
----------------
jmorse wrote:

Added some rewording to "Two methods", "pointer-flavoured", and stating that the methods use pointers as "code positions" because technically `getFirstNonPHI` isn't about insertion.

(It's a bit tricky to correctly abstract the wording over "this is about insertions but not all the functions are inserters".)

https://github.com/llvm/llvm-project/pull/127493