- Remove the "On failure the structure remains unchanged." part since
  that isn't necessarily true.
- Document the 'size' field.
Signed-off-by: NHans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: NMauro Carvalho Chehab <mchehab@redhat.com>