Some corner-cases are not explained properly.
Signed-off-by: NBen Hutchings <ben@decadent.org.uk>