2010-10-05 2 views
0

Я использую ювелирный камень при разработке новых драгоценных камней. В составе скелета он устанавливает набор связанных с RDoc рейк-задач - основной из которых - rake rdoc. Насколько я могу судить по Rakefile, эта задача использует библиотеку rake/rdoctask для создания документации HTML из моих комментариев RDoc.Невозможно получить RDoc для подавления перекрестных ссылок для определенного слова

Он пытается разумно делать ссылки на классы и методы внутри моих комментариев RDoc. Но, например, у меня есть метод, называемый user, каждый раз, когда я пишу user, генератор RDoc считает, что я ссылаюсь на этот метод. Согласно RDoc manual (в самом конце «Documenting Source Code»), это может быть отключено путем префикса слова с помощью обратного слэша (\) - например. \user.

Но в моем случае это не работает. Он просто выводит обратную косую черту в готовый HTML-документ и по-прежнему использует это слово в качестве перекрестной ссылки.

Любая идея, как я могу заставить это работать?

ответ

0

Вы, скорее всего, старая версия RDoc установлена, попробуйте обновить до 2.5 ветви с

gem install rdoc -v "~>2.5"