From 9c07375df8041910fe5e6e30347982fd864a4c0e Mon Sep 17 00:00:00 2001
From: Sylvain Lefebvre <sylvain.lefebvre@inria.fr>
Date: Thu, 9 Apr 2026 18:45:27 +0200
Subject: [PATCH] gatemate: improving comments in GateMateImpl:reassign_bridges

---
 himbaechel/uarch/gatemate/gatemate.cc | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/himbaechel/uarch/gatemate/gatemate.cc b/himbaechel/uarch/gatemate/gatemate.cc
index 27a56350..8d5ec89a 100644
--- a/himbaechel/uarch/gatemate/gatemate.cc
+++ b/himbaechel/uarch/gatemate/gatemate.cc
@@ -428,14 +428,14 @@ void GateMateImpl::preRoute()
 void GateMateImpl::reassign_bridges(NetInfo *start_nfo, const dict<WireId, PipMap> &net_wires,
                                     WireId start_wire, dict<WireId, IdString> &wire_to_net, int &num)
 {
-    // processing list, implements the equivalent of recursive calls
+    // Processing list, holds parameters to implement the equivalent of recursive calls.
     struct record { NetInfo *nfo; WireId wire; };
     std::vector<record> to_process;
-    // start record
+    // Insert start record.
     to_process.push_back({start_nfo, start_wire});
-    // for as long as there are pending records
+    // For as long as there are pending records, process them.
     while (!to_process.empty()) {
-
+	// Get the next record to process.
         record cur = to_process.back();
         to_process.pop_back();
 
@@ -458,7 +458,7 @@ void GateMateImpl::reassign_bridges(NetInfo *start_nfo, const dict<WireId, PipMa
             const auto &extra_data = *pip_extra_data(pip);
             // If not a bridge, just recurse.
             if (extra_data.type != PipExtra::PIP_EXTRA_MUX || !(extra_data.flags & MUX_ROUTING)) {
-                // recurse
+                // Insert in processing list (recurse).
                 to_process.push_back({cur.nfo, dst});
                 continue;
             }
@@ -491,8 +491,8 @@ void GateMateImpl::reassign_bridges(NetInfo *start_nfo, const dict<WireId, PipMa
             pass_backtrace[cell->name][id_MUXOUT] = in_port;
 
             num++;
-            // recurse
-            to_process.push_back({new_net,dst});
+            // Insert in processing list (recurse).
+            to_process.push_back({new_net, dst});
         }
     }
 }