Вопрос
Я пытаюсь создать RDoc, используя формат XML.Вот команда, которую я использую:
$ rdoc --fmt=xml --opname=api.xml
Файл создается, но список методов не создается.я использую rdoc (2.4.3)
.Шаблон RDoc для XML включает теги для отображения методов.
Является ли это возможным?
Решение
Начиная с версии 2.4 вывод XML не поддерживается.См., например. этот блог один из сопровождающих:
Генераторы HTML и XML перенесены в неподдерживаемый вариант.
- Никаких драгоценных камней предоставлено не будет, так как заставить их работать слишком сложно.
- Удалены параметры — one-file, — style=, — inline-source, — promiscous, —op-name
Я не думаю, что вы сможете использовать 2.4.3 — параметры, указанные в вашем примере, не работают для этой версии.Я только что скачал последнюю версию драгоценного камня и подтвердил это:
$ rdoc --format=xml --opname=api.xml
invalid argument: --format=xml
Возможно у вас старая версия rdoc
установлен, который появляется ранее в вашем $PATH
?
Я пытался rdoc 1.0.1
и получил описанное вами поведение (вывод XML, без методов).Итак, похоже, что ответ на ваш вопрос: «нет, это невозможно (было глючно, теперь не поддерживается)».
Вы можете попробовать предложить это как запрос функции, хотя похоже, что этого не произойдет в ближайшее время, если вообще когда-либо.