Генерация XML RDoc

Question

Я пытаюсь создать RDoc, используя формат XML.Вот команда, которую я использую:

$ rdoc --fmt=xml --opname=api.xml

Файл создается, но список методов не создается.я использую rdoc (2.4.3).Шаблон RDoc для XML включает теги для отображения методов.

Является ли это возможным?

Answer 1

Начиная с версии 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, без методов).Итак, похоже, что ответ на ваш вопрос: «нет, это невозможно (было глючно, теперь не поддерживается)».

Вы можете попробовать предложить это как запрос функции, хотя похоже, что этого не произойдет в ближайшее время, если вообще когда-либо.