r.sim.water: add info to manual, add info about progress

[metzm]

• r.sim.water is a module with a number of important but not well documented parameters. This PR adds more information about some parameters to the manual.
• It takes quite some time to run a simulation, another message is added to the progress of the simulation.

This PR tries to add info requested in #4475 to the manual

[hmitaso]

This sentence may be confusing "The model is for shallow water flow, where "shallow" is defined by hmax"- Perhaps the paragraph could start with "the model tries to keep water "shallow" with maximum shallow water depth defined by hmax value (default is 0.3m). If hmax is reached then .... here goes the text that explains the increase in diffusion rate and related parameters .... The rest of the text that explains when these parameters may need to be adjusted sounds good to me.

[metzm]

This new description comes from #4475, maybe @petrasovaa can clarify? I am not sure if the model tries to keep water "shallow". After hmax is reached, water flow can more easily overcome obstacles like sinks. "shallow" might here refer not to water depth, but to noise or sinks in the DEM used as input.

[metzm]

@hmitaso New try to explain diffusion in order to keep water shallow and to overcome obstacles in ad725c7.

[neteler]

Locally tested, looks good to me.

[neteler]

May this be merged, @petrasovaa ?

[petrasovaa]

Please remove this from here, maybe clarify in documentation or add benchmark there. Based on my experience (with r.sim.water, I don't know about r.sim.sediment) a few cores provide somespeed up, although I agree more than 4 cores probably not.

[metzm]

Done with bbf9117

[petrasovaa]

Could you elaborate on this? In your experience, there is no speedup at all? Because that's what the comment suggests. For sure it doesn't scale well, but at least for 4 threads the authors report 3x speedup.