From 7a8ae233d1bdf538a99233e52f0d7dd0975df2d1 Mon Sep 17 00:00:00 2001
From: Paul Eggert <eggert@cs.ucla.edu>
Date: Thu, 30 Mar 2017 17:47:58 -0700
Subject: [PATCH] * src/inotify.c (add_watch): Add comment.

---
 src/inotify.c | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/inotify.c b/src/inotify.c
index a0a89aa0f41..290701349ef 100644
--- a/src/inotify.c
+++ b/src/inotify.c
@@ -227,6 +227,9 @@ add_watch (int wd, Lisp_Object filename,
 	emacs_abort ();
     }
 
+  /* Insert the newly-assigned ID into the previously-discovered gap,
+     which is possibly at the end of the list.  Inserting it there
+     keeps the list sorted.  */
   watch_id = make_number (id);
   watch = list4 (watch_id, filename, callback, mask);
   XSETCDR (tail, Fcons (watch, XCDR (tail)));
-- 
2.39.2