Я думаю, что комментарии необходимы во многих ситуациях.
Например, подумайте об алгоритмических. Предположим, что есть функция, написанная на C, которая решает задачу коммивояжера , существует широкий спектр методов, которые можно использовать для решения этой проблемы. А коды обычно загадочны по своей природе.
Без явного описания параметров и используемого алгоритма с использованием комментариев практически невозможно повторно использовать этот фрагмент кода.
с использованием шаблонов просто :
$ hg log --template "{rev}: {file_dels}\n"