ramsey_policy: correcting the computation of the value of the
objective function; adding details about the period objective function
in the manual.

(cherry picked from commit 58c40fdca99c5b371f6d26125b7fc8ef817df6d2)