diff --git a/boot/bootutil/design.txt b/boot/bootutil/design.txt
index 47c4d28..eb5badb 100644
--- a/boot/bootutil/design.txt
+++ b/boot/bootutil/design.txt
@@ -203,13 +203,15 @@
                      | slot-0 | slot-1 |
     -----------------+--------+--------|
                magic | Any    | Good   |
-            image-ok | Any    | N/A    |
+            image-ok | Any    | [*]    |
     -----------------+--------+--------'
              pending |        |   X    |
           confirmed  |   X    |        |
-    -----------------+--------+--------'
-     swap: test                        |
-    -----------------------------------'
+    -----------------+--------+--------+----------------------------'
+     swap: test                                                     |
+     note: slot-1 image-ok val indicates whether swap is permanent; |
+           (0xff=temporary; 0x01=permanent)                         |
+    ----------------------------------------------------------------'
 
 
     State III
@@ -289,6 +291,9 @@
 crashes immediately upon booting the second image, the boot loader reverts to
 the working image, rather than repeatedly rebooting into the bad image.
 
+Alternatively, if the user is confident that the alternate image is good, they
+can set and confirm in a single action.
+
 The following set of tables illustrate the three possible states that the
 device can be in:
 
diff --git a/boot/bootutil/src/bootutil_misc.c b/boot/bootutil/src/bootutil_misc.c
index 1119bc2..c85f454 100644
--- a/boot/bootutil/src/bootutil_misc.c
+++ b/boot/bootutil/src/bootutil_misc.c
@@ -73,7 +73,7 @@
         /*          | slot-0     | slot-1     |
          *----------+------------+------------|
          *    magic | Any        | Good       |
-         * image-ok | Any        | N/A        |
+         * image-ok | Any        | [*]        |
          * ---------+------------+------------+---------------------------'
          * swap: test                                                     |
          * note: slot-1 image-ok val indicates whether swap is permanent; |