[COMMITTED,12/51] ada: Add note about Sem_Aux being in binder closure

Message ID 20260602084541.3829876-12-poulhies@adacore.com
State Committed
Commit 264a131335fb4c93820189706b6d4f8ab8e07439
Headers
Series [COMMITTED,01/51] ada: Rename Private_Component function |

Commit Message

Marc Poulhiès June 2, 2026, 8:45 a.m. UTC
  From: Ronan Desplanques <desplanques@adacore.com>

I recently realized that Sem_Aux is in the binder's closure, unlike
Sem_Util. This patch makes it explicit in a comment since it can be
useful when choosing where to put a helper subprogram.

gcc/ada/ChangeLog:

	* sem_aux.ads: Add note.

Tested on x86_64-pc-linux-gnu, committed on master.

---
 gcc/ada/sem_aux.ads | 5 +++++
 1 file changed, 5 insertions(+)
  

Patch

diff --git a/gcc/ada/sem_aux.ads b/gcc/ada/sem_aux.ads
index cf80ec793ba..3bd3a466476 100644
--- a/gcc/ada/sem_aux.ads
+++ b/gcc/ada/sem_aux.ads
@@ -30,6 +30,11 @@ 
 --  content of entities in the tree, so this package is used for routines that
 --  require more than minimal semantic knowledge.
 
+--  However, this package is in the closure of the binder executable. If you're
+--  looking for the home of a new helper function that uses significant
+--  semantic knowledge, Sem_Util, which is not in the closure of the binder
+--  executable, will be a more convenient place.
+
 with Alloc;
 with Einfo.Entities; use Einfo.Entities;
 with Namet; use Namet;