rlc: retarget the entity doc comments at the concrete compounds

Several RLC leaf entity comments still said "Bound by default to
BearerManagement.rlcUm{Rx,Tx}EntityModuleType" -- per-side parameters that
stopped existing in v1.5.1, when entity selection was consolidated onto the
per-bearer compound. Point them at the compound that actually binds them
(~LteRlcUmEntity, ~NrRlcAmEntity, ...) instead, list both concretes in the
RlcUm/RlcAmEntityBase comments now that the NR ones exist, and add the missing
~ cross-reference markers.

Comments only.

Author: avarga

simulations/lte/rlc/omnetpp.ini

@@ -104,7 +104,7 @@ num-rngs = 2
 #
 # As Base, but every traffic class is carried over RLC AM, so that the CBR flow
 # lands on an AM bearer whichever class it is mapped to. LTE bearers use the LTE
-# AM entities (RlcAmEntity with the LteRlcAm* sides) by default.
+# AM entities (LteRlcAmEntity) by default.
 #
 [Config AmBase]
 abstract = true

src/simu5g/stack/rlc/LteRlcAmEntity.ned

@@ -14,8 +14,8 @@ package simu5g.stack.rlc;
 //
 // RLC AM entity of an LTE data radio bearer: the ~RlcAmEntityBase compound with
 // its TX/RX sides bound to the LTE (FI wire format, TS 36.322) entity profiles.
-// Selected by BearerManagement via its lteRlcAmEntityModuleType parameter,
-// which defaults to this type.
+// Selected by BearerManagement for LTE bearers via its lteRlcAmEntityModuleType
+// parameter, which defaults to this type.
 //
 module LteRlcAmEntity extends RlcAmEntityBase
 {

src/simu5g/stack/rlc/LteRlcUmEntity.ned

@@ -14,8 +14,8 @@ package simu5g.stack.rlc;
 //
 // RLC UM entity of an LTE data radio bearer: the ~RlcUmEntityBase compound with
 // its TX/RX sides bound to the LTE (FI wire format, TS 36.322) entity profiles.
-// Selected by BearerManagement via its lteRlcUmEntityModuleType parameter,
-// which defaults to this type.
+// Selected by BearerManagement for LTE bearers via its lteRlcUmEntityModuleType
+// parameter, which defaults to this type.
 //
 module LteRlcUmEntity extends RlcUmEntityBase
 {

src/simu5g/stack/rlc/NrRlcAmEntity.ned

@@ -12,8 +12,8 @@
 package simu5g.stack.rlc;
 
 //
-// RLC AM entity of an NR data radio bearer: the RlcAmEntityBase compound with its
-// TX/RX sides defaulted to the NR (SI/SO wire format, TS 38.322) entity
+// RLC AM entity of an NR data radio bearer: the ~RlcAmEntityBase compound with
+// its TX/RX sides bound to the NR (SI/SO wire format, TS 38.322) entity
 // profiles. Selected by BearerManagement for NR bearers via its
 // nrRlcAmEntityModuleType parameter.
 //

src/simu5g/stack/rlc/NrRlcUmEntity.ned

@@ -12,8 +12,8 @@
 package simu5g.stack.rlc;
 
 //
-// RLC UM entity of an NR data radio bearer: the RlcUmEntityBase compound with its
-// TX/RX sides defaulted to the NR (SI/SO wire format, TS 38.322) entity
+// RLC UM entity of an NR data radio bearer: the ~RlcUmEntityBase compound with
+// its TX/RX sides bound to the NR (SI/SO wire format, TS 38.322) entity
 // profiles. Selected by BearerManagement for NR bearers via its
 // nrRlcUmEntityModuleType parameter.
 //

src/simu5g/stack/rlc/RlcAmEntityBase.ned

@@ -18,7 +18,7 @@ package simu5g.stack.rlc;
 // one per (peer, DRB) pair.
 //
 // This base type binds no TX/RX entity types; the concrete subclasses do
-// (~LteRlcAmEntity), so it is not instantiable on its own.
+// (~LteRlcAmEntity, ~NrRlcAmEntity), so it is not instantiable on its own.
 //
 // The receiving side hands control PDUs to the co-located transmitting side
 // over two internal connections:

src/simu5g/stack/rlc/RlcUmEntityBase.ned

@@ -18,7 +18,7 @@ package simu5g.stack.rlc;
 // a bearer with traffic in one direction only simply leaves the other side idle.
 //
 // This base type binds no TX/RX entity types; the concrete subclasses do
-// (~LteRlcUmEntity), so it is not instantiable on its own.
+// (~LteRlcUmEntity, ~NrRlcUmEntity), so it is not instantiable on its own.
 //
 module RlcUmEntityBase
 {

src/simu5g/stack/rlc/am/LteRlcAmTxEntity.ned

@@ -21,7 +21,7 @@ package simu5g.stack.rlc.am;
 // t-PollRetransmit, and radio link failure at maxRtxThreshold retransmissions.
 // Shares the common RlcAmTxEntityBase shell with the NR profile
 // ~NrRlcAmTxEntity, whose ARQ skeleton it deliberately mirrors. Bound by
-// default inside the ~RlcAmEntity compound.
+// default inside the ~LteRlcAmEntity compound.
 //
 simple LteRlcAmTxEntity like simu5g.stack.rlc.IRlcAmTxEntity
 {

src/simu5g/stack/rlc/am/NrRlcAmRxEntity.ned

@@ -15,9 +15,9 @@ package simu5g.stack.rlc.am;
 // NR (TS 38.322) receiving side of the Acknowledged Mode (AM) of the RLC
 // layer: SO byte-coverage reassembly with a per-SDU SN window, t-Reassembly +
 // t-StatusProhibit timers. Shares the common RlcAmRxEntityBase shell with the
-// LTE profile ~LteRlcAmRxEntity. Bound by default to
-// BearerManagement.nrRlcAmEntityModuleType. The NR SO-reassembly statistics
-// are declared here so they are recorded only for NR-selected entities.
+// LTE profile ~LteRlcAmRxEntity. Bound by default inside the ~NrRlcAmEntity
+// compound. The NR SO-reassembly statistics are declared here so they are
+// recorded only for NR-selected entities.
 //
 simple NrRlcAmRxEntity like simu5g.stack.rlc.IRlcAmRxEntity
 {

src/simu5g/stack/rlc/am/NrRlcAmTxEntity.ned

@@ -15,9 +15,9 @@ package simu5g.stack.rlc.am;
 // NR (TS 38.322) transmission side of the Acknowledged Mode (AM) of the RLC
 // layer: byte-offset (SO) segmentation with re-segmentation on retransmission,
 // pollByte/pollPDU-driven status polling. Shares the common RlcAmTxEntityBase
-// shell with the LTE profile ~LteRlcAmTxEntity. Bound by default to
-// BearerManagement.nrRlcAmEntityModuleType. The NR SO-segmentation
-// statistics are declared here so they are recorded only for NR entities.
+// shell with the LTE profile ~LteRlcAmTxEntity. Bound by default inside the
+// ~NrRlcAmEntity compound. The NR SO-segmentation statistics are declared here
+// so they are recorded only for NR entities.
 //
 simple NrRlcAmTxEntity like simu5g.stack.rlc.IRlcAmTxEntity
 {