2 files changed, 7 insertions, 2 deletions
diff --git a/ChangeLog b/ChangeLog
index aff57a34..3c69485d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2021-09-23         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawkapi.h: Some clean-up of comments in the header file.
+
 2021-09-12         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* interpret.h: Remove subscript_in_array variable.
diff --git a/gawkapi.h b/gawkapi.h
index 54130b15..7eccc70a 100644
--- a/gawkapi.h
+++ b/gawkapi.h
@@ -149,6 +149,7 @@ typedef struct awk_input {
 	int fd;			/* file descriptor */
 #define INVALID_HANDLE (-1)
 	void *opaque;           /* private data for input parsers */
+
 	/*
 	 * The get_record function is called to read the next record of data.
 	 *
@@ -187,8 +188,8 @@ typedef struct awk_input {
 			const awk_fieldwidth_info_t **field_width);
 
 	/*
-	 * No argument prototype on read_func to allow for older systems
-	 * whose headers are not up to date.
+	 * This replaces the POSIX read() system call. Use it if you want to
+	 * manage reading raw bytes yourself, and let gawk parse the record.
 	 */
 	ssize_t (*read_func)(int, void *, size_t);