While most corner cases have already been dealt with, some remain and
should be documented.
Signed-off-by: Miklos Szeredi <mszeredi@redhat.com>