diff --git a/content.py b/content.py
index a4bcb9e8..45e13e00 100644
--- a/content.py
+++ b/content.py
@@ -248,8 +248,12 @@ def addHtmlTags(baseDir: str,httpPrefix: str, \
             continue
         if len(wordStr)>2 and wordStr.startswith(':') and wordStr.endswith(':') and not emojiDict:
             print('Loading emoji lookup')
+
+            # emoji.json is generated so that it can be customized and the changes
+            # will be retained even if default_emoji.json is subsequently updated
             if not os.path.isfile(baseDir+'/emoji/emoji.json'):
                 copyfile(baseDir+'/emoji/default_emoji.json',baseDir+'/emoji/emoji.json')
+
             with open(baseDir+'/emoji/emoji.json', 'r') as fp:
                 emojiDict=commentjson.load(fp)
 
diff --git a/webinterface.py b/webinterface.py
index eb7df871..13b65ffd 100644
--- a/webinterface.py
+++ b/webinterface.py
@@ -55,6 +55,8 @@ def htmlSearchEmoji(translate: {},baseDir: str,searchStr: str) -> str:
     """Search results for emoji
     """
 
+    # emoji.json is generated so that it can be customized and the changes
+    # will be retained even if default_emoji.json is subsequently updated
     if not os.path.isfile(baseDir+'/emoji/emoji.json'):
         copyfile(baseDir+'/emoji/default_emoji.json',baseDir+'/emoji/emoji.json')
 
@@ -2348,6 +2350,8 @@ def htmlSearchEmojiTextEntry(translate: {}, \
                              baseDir: str,path: str) -> str:
     """Search for an emoji by name
     """
+    # emoji.json is generated so that it can be customized and the changes
+    # will be retained even if default_emoji.json is subsequently updated
     if not os.path.isfile(baseDir+'/emoji/emoji.json'):
         copyfile(baseDir+'/emoji/default_emoji.json',baseDir+'/emoji/emoji.json')