[Ada] Use pygments for Ada code examples of elaboration control

Only enhancement of formatting.

gcc/ada/

	* doc/gnat_ugn/elaboration_order_handling_in_gnat.rst: Change
	blocks from plain code to Ada.
This commit is contained in:
Piotr Trojanek 2022-01-30 18:39:39 +01:00 committed by Pierre-Marie de Rodat
parent 42c0119157
commit a473646ec8

View File

@ -93,7 +93,7 @@ Elaboration code may appear in two distinct contexts:
[body] compilation unit, ignoring any other package [body] declarations in
between.
::
.. code-block:: ada
with Server;
package Client is
@ -116,7 +116,7 @@ Elaboration code may appear in two distinct contexts:
bounded by the region starting from the ``begin`` keyword of the package body
and ending at the ``end`` keyword of the package body.
::
.. code-block:: ada
package body Client is
procedure Proc is
@ -142,7 +142,7 @@ executed is referred to as **elaboration order**.
Within a single unit, elaboration code is executed in sequential order.
::
.. code-block:: ada
package body Client is
Result : ... := Server.Func;
@ -190,13 +190,13 @@ factors:
A program may have several elaboration orders depending on its structure.
::
.. code-block:: ada
package Server is
function Func (Index : Integer) return Integer;
end Server;
::
.. code-block:: ada
package body Server is
Results : array (1 .. 5) of Integer := (1, 2, 3, 4, 5);
@ -207,14 +207,14 @@ A program may have several elaboration orders depending on its structure.
end Func;
end Server;
::
.. code-block:: ada
with Server;
package Client is
Val : constant Integer := Server.Func (3);
end Client;
::
.. code-block:: ada
with Client;
procedure Main is begin null; end Main;
@ -320,7 +320,7 @@ the desired elaboration order and avoiding ABE problems altogether.
A library package which does not require a completing body does not suffer
from ABE problems.
::
.. code-block:: ada
package Pack is
generic
@ -358,7 +358,7 @@ the desired elaboration order and avoiding ABE problems altogether.
scenario can invoke a server target before the target body has been
elaborated because the spec and body are effectively "glued" together.
::
.. code-block:: ada
package Server is
pragma Elaborate_Body;
@ -366,7 +366,7 @@ the desired elaboration order and avoiding ABE problems altogether.
function Func return Integer;
end Server;
::
.. code-block:: ada
package body Server is
function Func return Integer is
@ -375,7 +375,7 @@ the desired elaboration order and avoiding ABE problems altogether.
end Func;
end Server;
::
.. code-block:: ada
with Server;
package Client is
@ -425,13 +425,13 @@ depend on.
be elaborated prior to the unit with the pragma. Note that other unrelated
units may be elaborated in between the spec and the body.
::
.. code-block:: ada
package Server is
function Func return Integer;
end Server;
::
.. code-block:: ada
package body Server is
function Func return Integer is
@ -440,7 +440,7 @@ depend on.
end Func;
end Server;
::
.. code-block:: ada
with Server;
pragma Elaborate (Server);
@ -479,13 +479,13 @@ depend on.
|withed| by the spec and body of the argument, recursively. Note that other
unrelated units may be elaborated in between the spec and the body.
::
.. code-block:: ada
package Math is
function Factorial (Val : Natural) return Natural;
end Math;
::
.. code-block:: ada
package body Math is
function Factorial (Val : Natural) return Natural is
@ -494,7 +494,7 @@ depend on.
end Factorial;
end Math;
::
.. code-block:: ada
package Computer is
type Operation_Kind is (None, Op_Factorial);
@ -504,7 +504,7 @@ depend on.
Op : Operation_Kind) return Natural;
end Computer;
::
.. code-block:: ada
with Math;
package body Computer is
@ -520,7 +520,7 @@ depend on.
end Compute;
end Computer;
::
.. code-block:: ada
with Computer;
pragma Elaborate_All (Computer);
@ -738,7 +738,7 @@ execution. The warnings can be suppressed selectively with ``pragma Warnings
A *guaranteed ABE* arises when the body of a target is not elaborated early
enough, and causes *all* scenarios that directly invoke the target to fail.
::
.. code-block:: ada
package body Guaranteed_ABE is
function ABE return Integer;
@ -765,7 +765,7 @@ the declaration of ``Val``. This invokes function ``ABE``, however the body of
A *conditional ABE* arises when the body of a target is not elaborated early
enough, and causes *some* scenarios that directly invoke the target to fail.
::
.. code-block:: ada
1. package body Conditional_ABE is
2. procedure Force_Body is null;
@ -850,19 +850,19 @@ clauses, elaboration-control pragmas, or invocations in elaboration code.
The following example exhibits an elaboration circularity.
::
.. code-block:: ada
with B; pragma Elaborate (B);
package A is
end A;
::
.. code-block:: ada
package B is
procedure Force_Body;
end B;
::
.. code-block:: ada
with C;
package body B is
@ -871,13 +871,13 @@ The following example exhibits an elaboration circularity.
Elab : constant Integer := C.Func;
end B;
::
.. code-block:: ada
package C is
function Func return Integer;
end C;
::
.. code-block:: ada
with A;
package body C is