diff --git a/raster/r.sim/r.sim.water/r.sim.water.html b/raster/r.sim/r.sim.water/r.sim.water.html
index 7ce8d669f99..b7a2e332e69 100644
--- a/raster/r.sim/r.sim.water/r.sim.water.html
+++ b/raster/r.sim/r.sim.water/r.sim.water.html
@@ -109,10 +109,13 @@
DESCRIPTION
diffusion term increases as given by halpha and advection term
(direction of flow) is given as "prevailing" direction of flow computed
as average of flow directions from the previous hbeta number of grid cells.
-The model is for shallow water flow, where "shallow" is defined by hmax,
-default 0.3 meters. Depending on the area of interest and the used digital
-elevation model, hmax, halpha and hbeta might need to
-be adjusted in order to deal realistically with elevation depressions or obstacles.
+The model tries to keep water "shallow" with maximum shallow water
+depth defined by hmax default 0.3 meters. However, water depths
+much higher than hmax can be observed if water accumulates in
+natural sinks or river beds.Depending on the area of interest and the
+used digital elevation model, hmax, halpha and
+hbeta might need to be adjusted in order to deal realistically
+with elevation depressions or obstacles.
NOTES