[llvm] [MCA] New option -scheduling-info (PR #130574)

[Julien Villette via llvm-commits]

================
@@ -170,6 +170,20 @@ option specifies "``-``", then the output will also be sent to standard output.
   Enable extra scheduler statistics. This view collects and analyzes instruction
   issue events. This view is disabled by default.
 
+.. option:: -scheduling-info
+
+  Enable scheduling info view. This view reports scheduling information defined
+  in LLVM target description in the form:
+  ``<uOps> <Latency> <Bypass Latency> <Throughput> <LLVM Opcode Name> <Resources
+  units> <instruction and comment (// or /* */) if defined>``
+  It allows to compare scheduling info with architecture documents and fix them
+  in target description by fixing InstrRW for the reported LLVM opcode.
+  Scheduling information can be defined in the same order in each instruction
+  comments to check easily reported and reference scheduling information.
+  Suggested information in comment:
+  ``// <architecture instruction form> \\ <scheduling documentation title> \\
+  <uOps>, <Latency>, <Bypass Latency>, <Throughput>, <Resources units>``
+
----------------
jvillette38 wrote:

> I wonder whether we could reuse flag `-instruction-tables` instead of adding a new flag. e.g.:
> 
> ```
>  -instruction-tables    // print the default view (no extra info). This is the "normal" behavior.
>  -instruction-tables=normal    // same as above
>  -instruction-tables=full  // print the full view (this includes your extra fields)
> ```

Done in last commits. `-instruction-tables` is equivalent to `-instruction-tables=normal` to avoid to modify all tests.

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