Внутренние комментарии при использовании YARD для документации по Ruby?

Я нахожусь в процессе перехода 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?

6
задан David Hollman 11 January 2012 в 19:32
поделиться