diff --git a/internal/buffer/buffer.go b/internal/buffer/buffer.go
index 115cb64e..a51f2dc8 100644
--- a/internal/buffer/buffer.go
+++ b/internal/buffer/buffer.go
@@ -802,6 +802,8 @@ func (b *Buffer) UpdateRules() {
 		if length > 0 {
 			signatureMatch := false
 			if length > 1 {
+				// multiple matching syntax files found, try to resolve the ambiguity
+				// using signatures
 				detectlimit := util.IntOpt(b.Settings["detectlimit"])
 				lineCount := len(b.lines)
 				limit := lineCount