[gcc r13-3986] Revert "sphinx: sync latest changes"

[gcc r13-3986] Revert "sphinx: sync latest changes"

[Martin Liska]

https://gcc.gnu.org/g:56de1406bc90428b629a064e869b6fe9b24dcf43

commit r13-3986-g56de1406bc90428b629a064e869b6fe9b24dcf43
Author: Martin Liska <mliska@suse.cz>
Date:   Sun Nov 13 21:58:45 2022 +0100

    Revert "sphinx: sync latest changes"
    
    This reverts commit 8857a1e350cf34c4ac06429ec4cb97228489dd07.

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, 11 insertions(+), 7 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 6f015e9e96a..7e784eb9a07 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,6 +1457,10 @@ 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
@@ -1613,4 +1617,4 @@ on x86-64 processors in 64-bit environments.
 
 .. option:: -mdirect-extern-access
 
-  Default setting; overrides :option:`-mno-direct-extern-access`.
+  Default setting; overrides :option:`-mno-direct-extern-access`.
\ No newline at end of file
diff --git a/gcc/doc/gcc/gcc-command-options/option-summary.rst b/gcc/doc/gcc/gcc-command-options/option-summary.rst
index d068f98feac..e687b95b9ee 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` |gol|
+  :option:`-mprefetchi` :option:`-mraoint` :option:`-mprefer-remote-atomic`
   :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
+  .. program:: None
\ No newline at end of file
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 8fce5c3403a..6ece8a4577b 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 ``INIT_CUMULATIVE_ARGS``, maybe.
+  .. could use "this macro" in place of @code{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 7e6b1c978f6..bcdc87eecd0 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 ``PREFERRED_STACK_BOUNDARY``.
+  .. todo:: The default should be @code{PREFERRED_STACK_BOUNDARY}.
     But the fix for PR 32893 indicates that we can only guarantee
-    maximum stack alignment on stack up to ``STACK_BOUNDARY``, not
-    ``PREFERRED_STACK_BOUNDARY``, if stack alignment isn't supported.
+    maximum stack alignment on stack up to @code{STACK_BOUNDARY}, not
+    @code{PREFERRED_STACK_BOUNDARY}, if stack alignment isn't supported.
 
 .. c:macro:: MAX_OFILE_ALIGNMENT