$update method of acquisition functions should be better documented

[berndbischl]

i currently says basically nothing. if this is explained elsewhere, at least "point" to it