From 320a298394c366e9ea2a3fc58794bac9d4461d60 Mon Sep 17 00:00:00 2001
From: Jeff Young <jeff@rokeby.ie>
Date: Wed, 26 Feb 2025 10:55:19 +0000
Subject: [PATCH] Clarifying comments.

---
 pcbnew/router/pns_item.h | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/pcbnew/router/pns_item.h b/pcbnew/router/pns_item.h
index f00782e2e4..2605317fb9 100644
--- a/pcbnew/router/pns_item.h
+++ b/pcbnew/router/pns_item.h
@@ -314,9 +314,12 @@ private:
 
 protected:
     PnsKind         m_kind;
-
-    BOARD_ITEM*     m_parent;
-    BOARD_ITEM*     m_sourceItem;
+    BOARD_ITEM*     m_parent;       // The parent BOARD_ITEM, used when there is a 1:1 map
+                                    //   between the PNS::ITEM and the BOARD_ITEM.
+    BOARD_ITEM*     m_sourceItem;   // The progenator BOARD_ITEM for when there is NOT a 1:1 map.
+                                    //   For instance, dragging a track might produce multiple
+                                    //   segments, none of which can be directly mapped to the
+                                    //   track.
     PNS_LAYER_RANGE m_layers;
 
     bool            m_movable;