Я нахожусь в процессе перехода rubygem, который я поддерживаю, с RDoc на документацию YARD. Однако в коде есть некоторые критические замечания, которые должны оставаться только в коде и не должны появляться в документации. Например:
##
# SomeClass documentation here.
#--
# CRITICAL comment that should be in the code but not in the documentation,
# and must be at this particular spot in the code.
#++
# more documentation that follows the critical comment block, but this part
# should be in the generated documentation
class SomeClass
...
end
RDoc уважает ворота #--
и #++
, а YARD - нет. Каков (если он существует) синтаксис для выполнения аналогичных действий в разметке YARD?