Я не могу дать вам полный ответ, но Netbean любит использовать этот трюк в своем сгенерированном Java-коде.
Проблема в том, что исходный код Java должен быть средой между приложениями. Добавляя смысл к определенным комментариям, вы вынуждены придерживаться только Netbeans. Конечно, комментарии могут быть просто проигнорированы другими программами, но что, если эти комментарии будут перемещены или изменены? Я сделал это в Netbeans, и затем произошла некоторая забавность, когда я попытался загрузить файл обратно в Netbeans. Мне потребовалось время, чтобы исправить синтаксис (в комментариях!), Который, как предполагалось, был невидим для меня.
Лично я никогда бы не добавил больше смысла к существующему файлу, если бы он требовал более одной нелокальной модификации (то есть, вполне нормально иметь значение в одном комментарии, но не иметь смысла от этого комментария к этому комментарию ). Я определенно добавил бы другой файл, который в большинстве случаев содержал необходимые метаданные.