Improve the explanation of manual publisher functions.

Fixes #1018.