From: Bob Duff <duff@adacore.com>
Date: Tue, 22 May 2018 13:22:44 +0000 (+0000)
Subject: [Ada] Document new switches for gnatpp
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=714835398ed533b90d9bae265c176ac9bcdf5af3;p=gcc.git

[Ada] Document new switches for gnatpp

2018-05-22  Bob Duff  <duff@adacore.com>

gcc/ada/

	* doc/gnat_ugn/gnat_utility_programs.rst: Add documentation for
	the new --split-line-before-record, --indent-named-statements and
	--no-align-modes gnatpp switches.

From-SVN: r260515
---

diff --git a/gcc/ada/ChangeLog b/gcc/ada/ChangeLog
index c67e473f1f9..ad654795435 100644
--- a/gcc/ada/ChangeLog
+++ b/gcc/ada/ChangeLog
@@ -1,3 +1,9 @@
+2018-05-22  Bob Duff  <duff@adacore.com>
+
+	* doc/gnat_ugn/gnat_utility_programs.rst: Add documentation for
+	the new --split-line-before-record, --indent-named-statements and
+	--no-align-modes gnatpp switches.
+
 2018-05-22  Ed Schonberg  <schonberg@adacore.com>
 
 	* sem_prag.adb (Process_Compile_Time_Warning_Or_Error): Handle properly
diff --git a/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst b/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst
index d617dcd7211..2da86821a7e 100644
--- a/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst
+++ b/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst
@@ -2893,9 +2893,11 @@ Alternatively, you may run the script using the following command line:
      * ``=>`` in associations, and
      * ``at`` keywords in the component clauses in record representation clauses.
 
+   In addition, ``in`` and ``out`` in parameter specifications are lined up.
 
    .. index:: --no-alignment (gnatpp)
    .. index:: --alignment (gnatpp)
+   .. index:: --no-align-modes (gnatpp)
 
 
    :switch:`--no-alignment`
@@ -2905,6 +2907,10 @@ Alternatively, you may run the script using the following command line:
    :switch:`--alignment`
      Set alignment to ON
 
+
+   :switch:`--no-align-modes`
+     Do not line up ``in`` and ``out`` in parameter specifications.
+
    .. _Casing_Control:
 
 
@@ -3057,6 +3063,14 @@ Alternatively, you may run the script using the following command line:
      Pragma names are mixed case (this is the default)
 
 
+   .. index:: --syntax-only (gnatpp)
+
+   :switch:`--syntax-only`
+     Disable the semantic analysis (name resolution) done by libadalang.
+     This means gnatpp will not be able to support any of the
+     "as-declared" switches.
+
+
    .. index:: --dictionary (gnatpp)
 
    :switch:`--dictionary={file}`
@@ -3238,6 +3252,19 @@ Alternatively, you may run the script using the following command line:
      changed to ``16#0001_FFFE#``.
 
 
+   .. index:: --split-line-before-record (gnatpp)
+
+   :switch:`--split-line-before-record`
+     Split the line just before ``record`` in a record type declaration.
+
+
+   .. index:: --indent-named-statements (gnatpp)
+
+   :switch:`--indent-named-statements`
+     Named block and loop statements are indented with respect to
+     the name.
+
+
    .. index:: --split-line-before-op (gnatpp)
 
    :switch:`--split-line-before-op`