incrontab(1) mangles comments in incrontab(5): it changes the first word on every comment line to "0". For example, if I run incrontab and create a file with the following comment lines: # Only put 1 space between fields 2 and 3! Additional whitespace will be # assumed to be part of field 3, causing the command to fail! then incrontab -l shows that I have the following incrontab file: # 0 put 1 space between fields 2 and 3! Additional whitespace will be # 0 to be part of field 3, causing the command to fail!
To clarify, this doesn't just matter because of comments, although they're important. It also means that I can't temporarily disable a line by commenting it out-- if I do, then incrontab will replace the path entry by a 0. Thanks, Andrew.