[Ada] Warning for out-of-order record representation clauses

[thirdparty/gcc.git] / gcc / ada / doc / gnat_ugn / building_executable_programs_with_gnat.rst

diff --git a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst
index 913d6b9f3dd57636b2e2f607d4756088ebe82fe4..82aecc89a28fae65babc169b9d8ac35a2a132d44 100644 (file)
--- a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst
+++ b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst
@@ -2760,7 +2760,7 @@ of the pragma in the :title:`GNAT_Reference_manual`).
 :switch:`-gnatwa`
   *Activate most optional warnings.*
 
-  This switch activates most optional warning messages.  See the remaining list
+  This switch activates most optional warning messages. See the remaining list
   in this section for details on optional warning messages that can be
   individually controlled.  The warnings that are not turned on by this
   switch are:
@@ -2790,6 +2790,8 @@ of the pragma in the :title:`GNAT_Reference_manual`).
 
   * :switch:`-gnatw.q` (questionable layout of record types)
 
+  * :switch:`-gnatw_r` (out-of-order record representation clauses)
+
   * :switch:`-gnatw.s` (overridden size clause)
 
   * :switch:`-gnatwt` (tracking of deleted conditional code)
@@ -3708,7 +3710,7 @@ of the pragma in the :title:`GNAT_Reference_manual`).
   warnings are given.
 
 
-.. index:: -gnatwT  (gcc)
+.. index:: -gnatw.R  (gcc)
 
 :switch:`-gnatw.R`
   *Suppress warnings for object renaming function.*
@@ -3716,6 +3718,23 @@ of the pragma in the :title:`GNAT_Reference_manual`).
   This switch suppresses warnings for object renaming function.
 
 
+.. index:: -gnatw_r  (gcc)
+
+:switch:`-gnatw_r`
+  *Activate warnings for out-of-order record representation clauses.*
+
+  This switch activates warnings for record representation clauses,
+  if the order of component declarations, component clauses,
+  and bit-level layout do not all agree.
+  The default is that these warnings are not given.
+
+
+.. index:: -gnatw_R  (gcc)
+
+:switch:`-gnatw_R`
+  *Suppress warnings for out-of-order record representation clauses.*
+
+
 .. index:: -gnatws  (gcc)
 
 :switch:`-gnatws`