objective function; adding details about the period objective function
in the manual.

(cherry picked from commit 58c40fdc)