From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 2100) id B6E2D398403B; Sat, 22 Aug 2020 21:50:34 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org B6E2D398403B DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1598133034; bh=Yh7AAdwZ5/fSnpeOh7ww4SCK4op9Z6vI6KCRofp5kzE=; h=From:To:Subject:Date:From; b=oRFMUkorAMzNLXGpqHm9gs7G/JrStJyrmNu/elTE7wfO20hNpTMPkauMjDaEEPWw/ H3A8CUahZ3mFR09fI3ZdY/ssf/2Ls/VepUbTWfCF4MiG9UOx+7Dz5Bn25pdvoXjiz+ j7oCvpFRn7f75Sb4jwuTEJYvy2oTBN20ZXzav85s= Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Giuliano Belinassi To: gcc-cvs@gcc.gnu.org Subject: [gcc/devel/autopar_devel] [Ada] gnatpp: documentation for --[no-]compact switch X-Act-Checkin: gcc X-Git-Author: Bob Duff X-Git-Refname: refs/heads/devel/autopar_devel X-Git-Oldrev: 1c0791732cd02b4078cf3fad9c831931ebe3044e X-Git-Newrev: 2a11a1d1734feffebadf2bbf457f083253a79e87 Message-Id: <20200822215034.B6E2D398403B@sourceware.org> Date: Sat, 22 Aug 2020 21:50:34 +0000 (GMT) X-BeenThere: gcc-cvs@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-cvs mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 22 Aug 2020 21:50:34 -0000 https://gcc.gnu.org/g:2a11a1d1734feffebadf2bbf457f083253a79e87 commit 2a11a1d1734feffebadf2bbf457f083253a79e87 Author: Bob Duff Date: Mon Dec 23 07:44:49 2019 -0500 [Ada] gnatpp: documentation for --[no-]compact switch 2020-06-02 Bob Duff gcc/ada/ * doc/gnat_ugn/gnat_utility_programs.rst: Add documentation for --[no-]compact switch. Diff: --- gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst | 37 ++++++++++++++++++++++---- 1 file changed, 32 insertions(+), 5 deletions(-) diff --git a/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst b/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst index 6e836a72d80..13771f9f510 100644 --- a/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst +++ b/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst @@ -2790,7 +2790,7 @@ Alternatively, you may run the script using the following command line: Use the specified subdirectory of the project objects file (or of the project file directory if the project does not specify an object directory) for tool output files. Has no effect if no project is specified as - tool argument r if :switch:`--no_objects_dir` is specified. + tool argument r if :switch:`--no-objects-dir` is specified. .. index:: --files (gnatmetric) @@ -3415,6 +3415,33 @@ Alternatively, you may run the script using the following command line: '(' and ':'. This also turns off alignment. + .. index:: --compact (gnatpp) + .. index:: --no-compact (gnatpp) + + :switch:`--compact` + This is the default. In calls and similar, this packs as many + subexpressions on the same line as possible. Example: + + .. code-block:: ada + + Some_Procedure + (Short_One, Another_Short_One, + A_Very_Very_Very_Very_Very_Very_Very_Very_Long_One); + + :switch:`--no-compact` + Turns off --compact mode. In calls and similar, if it is necessary + to split a line between two subexpressions (because otherwise the + construct would exceed --max-line-length), then all such subexpressions + are placed on separate lines. Example: + + .. code-block:: ada + + Some_Procedure + (Short_One, + Another_Short_One, + A_Very_Very_Very_Very_Very_Very_Very_Very_Long_One); + + .. index:: --call_threshold (gnatpp) :switch:`--call_threshold={nnn}` @@ -4246,7 +4273,7 @@ Alternatively, you may run the script using the following command line: (See :ref:`Using_Project_Files_with_GNAT_Tools` for a description of the project-related switches but note that ``gnatstub`` does not support the :switch:`-U`, :switch:`-U {main_unit}`, :switch:`--subdirs={dir}`, or - :switch:`--no_objects_dir` switches.) + :switch:`--no-objects-dir` switches.) The project file package that can specify ``gnatstub`` switches is named ``gnatstub``. @@ -4543,7 +4570,7 @@ Alternatively, you may run the script using the following command line: (See :ref:`Using_Project_Files_with_GNAT_Tools` for a description of the project-related switches but note that ``gnattest`` does not support the :switch:`-U`, :switch:`-eL`, :switch:`--subdirs={dir}`, or - :switch:`--no_objects_dir` switches.) + :switch:`--no-objects-dir` switches.) The project file package that can specify ``gnattest`` switches is named ``gnattest``. @@ -5634,9 +5661,9 @@ Alternatively, you may run the script using the following command line: Use the ``dir`` subdirectory of the project's object directory (or the ``dir`` subdirectory of the project file directory if the project does not specify an object directory) for tool output files. Has no effect if no project - has been specified or if :switch:`--no_objects_dir` is specified. + has been specified or if :switch:`--no-objects-dir` is specified. - :switch:`--no_objects_dir` + :switch:`--no-objects-dir` Place all the result files into the current directory (i.e., the directory from which the tool invocation command is issued) instead of the project's object directory. Has no effect if no project has been specified.