commit 1dcb685143de3ae370c5d8e62058a41f963f2d6b
author Marti Bolivar <marti.bolivar@linaro.org> Fri Aug 04 15:59:32 2017 -0400
committer Marti Bolivar <marti.bolivar@linaro.org> Fri Aug 04 17:45:13 2017 -0400
tree db7a36cf13879bbdc7eb6c27286d10e07a0cf3fb
parent 42818032599df8cf94f68473b77b6999e6451503

doc: design: fixes and improvements for swap status definition

The swap status field definition claims image data are swapped one
sector at a time, but that's not true: image data are actually swapped
around in increments equal to the size of the scratch area, which
can be multiple sectors in length.

Its contents are also misleading in claiming that it's a series of
single byte records, which ignores padding when min-write-size > 1.

It also assumes the reader knows how images are swapped, but that's
not explained until later on in the document.

Finally, the paragraph is in a list of "definitions" of the image
trailer's fields, but it doesn't actually define the contents; it's
just a high level description of what the field is for.

Fix all of these issues by re-working this paragraph.

Signed-off-by: Marti Bolivar <marti.bolivar@linaro.org>