Issue #2057809 by StephaneQ, Berdir, chx, dawehner: Fix up param/return documentation in database API