DriftingOscillatorBase: Added documentation.

Author: levy

src/inet/clock/base/DriftingOscillatorBase.ned

@@ -8,8 +8,21 @@
 package inet.clock.base;
 
 //
-// Base module for oscillators that drift relative to the nominal tick
-// length over time.
+// Base module for oscillators whose effective tick rate may drift relative to a
+// nominal tick length. This module provides the mapping used by clocks without
+// generating one event per tick.
+//
+// Summary
+// -------
+// - Defines a computation origin o (o ≤ now) and a nominal tick length L.
+// - Actual tick spacing may differ from L due to drift/compensation; the
+//   current tick length is managed internally and may change over time.
+// - Mapping operations follow ~IOscillator semantics:
+//     N(Δt): number of ticks in (0, Δt] from the origin,
+//     I(n) : minimal Δt ≥ 0 such that N(Δt) ≥ n.
+// - When rate-related state changes, the origin and phase are updated so that
+//   the first tick not earlier than the change time remains consistent (no
+//   double or missed ticks).
 //
 simple DriftingOscillatorBase extends OscillatorBase
 {