diff --git a/ModelicaReference/package.mo b/ModelicaReference/package.mo
index e049ea2ee8..d874e78496 100644
--- a/ModelicaReference/package.mo
+++ b/ModelicaReference/package.mo
@@ -4669,13 +4669,17 @@ the return value changes discontinuously.]
extends ModelicaReference.Icons.Information;
annotation (Documentation(info="
-Trigger time events
+Trigger time events, or convert variables to clocked discrete-time domain
Syntax
sample(start, interval)
+y = sample(u, c)
Description
-Returns true and triggers time events at time instants
-"start + i*interval" (i=0, 1, ...).
+
Returns either:
+
+ - true and triggers time events at time instants
"start + i*interval" (i=0, 1, ...), or
+ - a clocked variable y that has c as associated clock and has the value of the left limit of u when c is active (that is the value of u just before the event of c is triggered)
+
During continuous integration the operator returns always
false. The starting time "start" and the sample
interval "interval" need to be parameter