pool: Fix minor errors in migration module documentation

Target: trunk
Require-notes: no
Require-book: yes
Acked-by: Tigran Mkrtchyan <tigran.mkrtchyan@desy.de>
Patch: https://rb.dcache.org/r/7338/