[gcc(refs/users/marxin/heads/sphinx-final)] sphinx: sync latest changes

[Martin Liska]

https://gcc.gnu.org/g:1daa89276eb788fe3fee96d7d31648c9346923af

commit 1daa89276eb788fe3fee96d7d31648c9346923af
Author: Martin Liska <mliska@suse.cz>
Date:   Mon Nov 7 22:18:24 2022 +0100

    sphinx: sync latest changes
    
    gcc/ChangeLog:
    
            * doc/gccint/target-macros/stack-layout-and-calling-conventions/passing-arguments-in-registers.rst:
            Port to RST.
            * doc/gccint/target-macros/storage-layout.rst: Likewise.
            * doc/gcc/gcc-command-options/machine-dependent-options/x86-options.rst: Sync with master.
            * doc/gcc/gcc-command-options/option-summary.rst: Likewise.

Diff:
---
 .../gcc-command-options/machine-dependent-options/x86-options.rst   | 6 +-----
 gcc/doc/gcc/gcc-command-options/option-summary.rst                  | 4 ++--
 .../passing-arguments-in-registers.rst                              | 2 +-
 gcc/doc/gccint/target-macros/storage-layout.rst                     | 6 +++---
 4 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/gcc/doc/gcc/gcc-command-options/machine-dependent-options/x86-options.rst b/gcc/doc/gcc/gcc-command-options/machine-dependent-options/x86-options.rst
index 7e784eb9a07..6f015e9e96a 100644
--- a/gcc/doc/gcc/gcc-command-options/machine-dependent-options/x86-options.rst
+++ b/gcc/doc/gcc/gcc-command-options/machine-dependent-options/x86-options.rst
@@ -1457,10 +1457,6 @@ These :samp:`-m` options are defined for the x86 family of computers.
   cachline bouncing when and works for all atomic logic fetch builtins
   that generates compare and swap loop.
 
-.. option:: -mprefer-remote-atomic
-
-  Prefer use remote atomic insn for atomic operations.
-
 .. option:: -mindirect-branch={choice}
 
   Convert indirect call and jump with :samp:`{choice}`.  The default is
@@ -1617,4 +1613,4 @@ on x86-64 processors in 64-bit environments.
 
 .. option:: -mdirect-extern-access
 
-  Default setting; overrides :option:`-mno-direct-extern-access`.
\ No newline at end of file
+  Default setting; overrides :option:`-mno-direct-extern-access`.
diff --git a/gcc/doc/gcc/gcc-command-options/option-summary.rst b/gcc/doc/gcc/gcc-command-options/option-summary.rst
index e687b95b9ee..d068f98feac 100644
--- a/gcc/doc/gcc/gcc-command-options/option-summary.rst
+++ b/gcc/doc/gcc/gcc-command-options/option-summary.rst
@@ -1466,7 +1466,7 @@ in the following sections.
   :option:`-mrdseed`  :option:`-msgx` :option:`-mavx512vp2intersect` :option:`-mserialize` :option:`-mtsxldtrk` |gol|
   :option:`-mamx-tile`  :option:`-mamx-int8`  :option:`-mamx-bf16` :option:`-muintr` :option:`-mhreset` :option:`-mavxvnni` |gol|
   :option:`-mavx512fp16` :option:`-mavxifma` :option:`-mavxvnniint8` :option:`-mavxneconvert` :option:`-mcmpccxadd` :option:`-mamx-fp16` |gol|
-  :option:`-mprefetchi` :option:`-mraoint` :option:`-mprefer-remote-atomic`
+  :option:`-mprefetchi` :option:`-mraoint` |gol|
   :option:`-mcldemote`  :option:`-mms-bitfields`  :option:`-mno-align-stringops`  :option:`-minline-all-stringops` |gol|
   :option:`-minline-stringops-dynamically`  :option:`-mstringop-strategy=alg` |gol|
   :option:`-mkl` :option:`-mwidekl` |gol|
@@ -1524,4 +1524,4 @@ in the following sections.
 
   See :ref:`s-390-and-zseries-options`.
 
-  .. program:: None
\ No newline at end of file
+  .. program:: None
diff --git a/gcc/doc/gccint/target-macros/stack-layout-and-calling-conventions/passing-arguments-in-registers.rst b/gcc/doc/gccint/target-macros/stack-layout-and-calling-conventions/passing-arguments-in-registers.rst
index 6ece8a4577b..8fce5c3403a 100644
--- a/gcc/doc/gccint/target-macros/stack-layout-and-calling-conventions/passing-arguments-in-registers.rst
+++ b/gcc/doc/gccint/target-macros/stack-layout-and-calling-conventions/passing-arguments-in-registers.rst
@@ -118,7 +118,7 @@ the stack.
   argument :samp:`{libname}` exists for symmetry with
   ``INIT_CUMULATIVE_ARGS``.
 
-  .. could use "this macro" in place of @code{INIT_CUMULATIVE_ARGS}, maybe.
+  .. could use "this macro" in place of ``INIT_CUMULATIVE_ARGS``, maybe.
 
   .. -mew 5feb93   i switched the order of the sentences.  -mew 10feb93
 
diff --git a/gcc/doc/gccint/target-macros/storage-layout.rst b/gcc/doc/gccint/target-macros/storage-layout.rst
index bcdc87eecd0..7e6b1c978f6 100644
--- a/gcc/doc/gccint/target-macros/storage-layout.rst
+++ b/gcc/doc/gccint/target-macros/storage-layout.rst
@@ -217,10 +217,10 @@ See :ref:`run-time-target`.
 
   If not defined, the default value is ``STACK_BOUNDARY``.
 
-  .. todo:: The default should be @code{PREFERRED_STACK_BOUNDARY}.
+  .. todo:: The default should be ``PREFERRED_STACK_BOUNDARY``.
     But the fix for PR 32893 indicates that we can only guarantee
-    maximum stack alignment on stack up to @code{STACK_BOUNDARY}, not
-    @code{PREFERRED_STACK_BOUNDARY}, if stack alignment isn't supported.
+    maximum stack alignment on stack up to ``STACK_BOUNDARY``, not
+    ``PREFERRED_STACK_BOUNDARY``, if stack alignment isn't supported.
 
 .. c:macro:: MAX_OFILE_ALIGNMENT