Documentation improvement (fixes #932)
Another documentation improvement for #932.
Yet another documentation improvement for #932.

Now it should be clear that the map's changelayer event is triggered
whenever the layer's actual visibility (i.e. visible to the user) changes.