[Docs] Added llvm-reduce docs in commandGuide

[dblaikie]

llvm/docs/CommandGuide/llvm-reduce.rst

9

14

This sentence feels a bit awkward - the "The x tool project that can" maybe could be modeled after https://llvm.org/docs/CommandGuide/llvm-dwarfdump.html for instance, like:

"llvm-reduce reduces the size of LLVM test cases"

And might be worth mentioning tools like creduce, cvise, delta/multidelta as comparisons/similar tools/interfaces?

21

/probably/ use ":program:llvm-reduce" as before/in the first paragraph rather than trying to figure out how to capitalize the tool name in a sentence

[arsenm]

reverse ping?

[arsenm]

Was this just a double post of D146020? I thought this went in already

llvm/docs/CommandGuide/llvm-mc.rst

 
 .. option::   --relax-relocations  
 
  Emit R_X86_64_GOTPCRELX instead of R_X86_64_GOTPCREL.
 
 .. option:: --print-imm-hex      
 
  Prefer hex format for immediate values.
+ For example, on x86 targets --output-asm-variant=0 prints in AT&T syntax, and --output-asm-variant=1 prints in Intel/MASM syntax.
 
 .. option::  --preserve-comments 
 
  Preserve Comments in outputted assembly.
 
 .. option:: --output-asm-variant=<uint>
 
  Syntax variant to use for output printing.

llvm/docs/CommandGuide/llvm-reduce.rst

+llvm-reduce - LLVM automatic testcase reducer.
+==============================================
+
+.. program:: llvm-reduce
+
+SYNOPSIS
+--------
+
+:program:`llvm-reduce` [*options*] [*input...*]
+
+DESCRIPTION
+-----------
+
+The :program:`llvm-reduce` tool project that can be used for reducing the size of LLVM test cases.
+It works by removing redundant or unnecessary code from LLVM test cases while still preserving 
+their ability to detect bugs.
+
+If ``input`` is "``-``", :program:`llvm-reduce` reads from standard
+input. Otherwise, it will read from the specified ``filenames``.
+
+LLVM-Reduce is a useful tool for reducing the size and 
+complexity of LLVM test cases, making it easier to identify and debug issues in 
+the LLVM compiler infrastructure.
+
+GENERIC OPTIONS
+---------------
+
+
+.. option:: --help
+
+ Display available options (--help-hidden for more).
+
+.. option:: --abort-on-invalid-reduction
+
+ Abort if any reduction results in invalid IR
+
+.. option::--delta-passes=<string>  
+
+ Delta passes to run, separated by commas. By default, run all delta passes.
+
+
+.. option:: --in-place     
+
+ WARNING: This option will replace your input file with the reduced version!
+
+.. option:: --ir-passes=<string> 
+
+ A textual description of the pass pipeline, same as what's passed to `opt -passes`.
+
+.. option:: -j <uint>  
+
+ Maximum number of threads to use to process chunks. Set to 1 to disable parallelism.
+
+.. option::  --max-pass-iterations=<int>
+
+  Maximum number of times to run the full set of delta passes (default=5).
+
+.. option:: --mtriple=<string> 
+
+ Set the target triple.
+
+.. option:: --preserve-debug-environment
+
+ Don't disable features used for crash debugging (crash reports, llvm-symbolizer and core dumps)
+
+.. option:: --print-delta-passes  
+
+ Print list of delta passes, passable to --delta-passes as a comma separated liste.
+
+.. option:: --skip-delta-passes=<string>     
+
+ Delta passes to not run, separated by commas. By default, run all delta passes.
+
+.. option:: --starting-granularity-level=<uint>
+
+  Number of times to divide chunks prior to first test.
+  
+  Note : Granularity refers to the level of detail at which the reduction process operates.
+  A lower granularity means that the reduction process operates at a more coarse-grained level,
+  while a higher granularity means that it operates at a more fine-grained level.
+
+.. option::  --test=<string> 
+
+ Name of the interesting-ness test to be run.
+
+.. option:: --test-arg=<string> 
+
+ Arguments passed onto the interesting-ness test.
+
+.. option:: --verbose    
+
+ Print extra debugging information.
+ 
+.. option::  --write-tmp-files-as-bitcode  
+
+ Always write temporary files as bitcode instead of textual IR.
+
+.. option:: -x={ir|mir}
+
+ Input language as ir or mir.
+
+EXIT STATUS
+------------
+
+:program:`llvm-reduce` returns 0 under normal operation. It returns a non-zero
+exit code if there were any errors.
+

llvm/docs/LangRef.rst

 ::
 
       <result> = frem [fast-math flags]* <ty> <op1>, <op2>   ; yields ty:result
 
 Overview:
 """""""""
 
 The '``frem``' instruction returns the remainder from the division of
-its two operands.
+its two operands. On some target, such as X86, the instruction is 
+implemented as call to '``libm``' '``fmod``' function, but the 
+output is equivalent to the mathematical remainder.
 
 Arguments:
 """"""""""
 
 The two arguments to the '``frem``' instruction must be
 :ref:`floating-point <t_floating>` or :ref:`vector <t_vector>` of
 floating-point values. Both arguments must have identical types.