Move the sources documentation up below the marker for deprecated
otpions. Also mention the new block parameter, that was added
in 74972220.
Signed-off-by: Martin Storsjö <martin@martin.st>