[llvm] [OpenMP] [IR Builder] Changes to Support Scan Operation (PR #136035)

[Michael Kruse via llvm-commits]

================
@@ -2639,6 +2725,46 @@ class OpenMPIRBuilder {
                                              FinalizeCallbackTy FiniCB,
                                              Value *Filter);
 
+  /// This function performs the scan reduction of the values updated in
+  /// the input phase. The reduction logic needs to be emitted between input
+  /// and scan loop returned by `CreateCanonicalScanLoops`. The following
+  /// is the code that is generated, `buffer` and `span` are expected to be
+  /// populated before executing the generated code.
+  ///
+  ///  for (int k = 0; k != ceil(log2(span)); ++k) {
+  ///    i=pow(2,k)
+  ///    for (size cnt = last_iter; cnt >= i; --cnt)
+  ///      buffer[cnt] op= buffer[cnt-i];
+  ///  }
----------------
Meinersbur wrote:

```suggestion
  /// \code{c}
  /// for (int k = 0; k != ceil(log2(span)); ++k) {
  ///   i=pow(2,k)
  ///   for (size cnt = last_iter; cnt >= i; --cnt)
  ///     buffer[cnt] op= buffer[cnt-i];
  /// }
  /// \endcode
```
Doxygen syntax for verbatim paragraphs

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