[gcc r16-1164] ada: Tweak wording of documentation comments in Atree

[Marc Poulhies]

https://gcc.gnu.org/g:b35d2322d7b970e1e6eab2094bfebbccf661ae17

commit r16-1164-gb35d2322d7b970e1e6eab2094bfebbccf661ae17
Author: Ronan Desplanques <desplanques@adacore.com>
Date:   Fri Feb 7 14:43:37 2025 +0100

    ada: Tweak wording of documentation comments in Atree
    
    This patch removes an outdated reference to the concept of node
    extensions in comments. It also slightly clarifies the documentation of
    Atree.Relocate_Node.
    
    gcc/ada/ChangeLog:
    
            * atree.ads (New_Copy, Relocate_Node): Tweak documentation comments.

Diff:
---
 gcc/ada/atree.ads | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/gcc/ada/atree.ads b/gcc/ada/atree.ads
index dc5fe0d8ad61..c8cc2bcf0c4f 100644
--- a/gcc/ada/atree.ads
+++ b/gcc/ada/atree.ads
@@ -299,20 +299,19 @@ package Atree is
    --  This function allocates a new node, and then initializes it by copying
    --  the contents of the source node into it. The contents of the source node
    --  is not affected. The target node is always marked as not being in a list
-   --  (even if the source is a list member), and not overloaded. The new node
-   --  will have an extension if the source has an extension. New_Copy (Empty)
-   --  returns Empty, and New_Copy (Error) returns Error. Note that, unlike
-   --  Copy_Separate_Tree, New_Copy does not recursively copy any descendants,
-   --  so in general parent pointers are not set correctly for the descendants
-   --  of the copied node.
+   --  (even if the source is a list member), and not overloaded.
+   --  New_Copy (Empty) returns Empty, and New_Copy (Error) returns Error. Note
+   --  that, unlike Copy_Separate_Tree, New_Copy does not recursively copy any
+   --  descendants, so in general parent pointers are not set correctly for the
+   --  descendants of the copied node.
 
    function Relocate_Node (Source : Node_Id) return Node_Id;
    --  Source is a non-entity node that is to be relocated. A new node is
    --  allocated, and the contents of Source are copied to this node, using
    --  New_Copy. The parent pointers of descendants of the node are then
    --  adjusted to point to the relocated copy. The original node is not
-   --  modified, but the parent pointers of its descendants are no longer
-   --  valid. The new copy is always marked as not overloaded. This routine is
+   --  modified, but the parent pointers of its children no longer point back
+   --  at it. The new copy is always marked as not overloaded. This routine is
    --  used in conjunction with the tree rewrite routines (see descriptions of
    --  Replace/Rewrite).
    --