From 8789016b21d9856c9f725c56273df5273c4f50c2 Mon Sep 17 00:00:00 2001
From: David Chisnall <theraven@FreeBSD.org>
Date: Tue, 20 Mar 2018 15:00:56 +0000
Subject: [PATCH] Improve a comment.

---
 protocol.h | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/protocol.h b/protocol.h
index d44cd3c..e210b67 100644
--- a/protocol.h
+++ b/protocol.h
@@ -112,9 +112,10 @@ struct objc_protocol_list
 	 */
 	size_t                     count;
 	/**
-	 * An array of protocols.  Actually contains count elements, not 1.
+	 * An array of protocols.  Contains `count` elements.
 	 *
-	 * The instances in this array may be any version of protocols.
+	 * On load, this contains direct references to other protocols and should
+	 * be updated to point to the canonical (possibly upgraded) version.
 	 */
 	Protocol2                 *list[];
 };