Ответ

moko 25.11.2016 20:47

Не я писал документацию, но мне так кажется, что с документацией все относительно в порядке, если ее понимать буквально: "Используется для комментирования блоков кода". То есть во-первых, это должен быть код, а значит подразумевается синтаксическая корректность. Во-вторых, речь о блоке кода. В моем понимании два метода - это не блок кода, блок кода например на C++ это что-то в фигурных скобках. Так и здесь получается - если можно поставить ^rem{} и ничего не развалилось - это блок кода. А если развалилось - значит это просто был не блок кода. :)
Ну а по сути думаю там просто примеров надо добавить.

---