Pergunta
Eu estou tentando gerar um RDoc usando o formato XML. Aqui é o comando que estou usando:
$ rdoc --fmt=xml --opname=api.xml
O arquivo é criado, mas nenhuma lista de método é gerada. Estou usando rdoc (2.4.3)
. O modelo RDoc para XML incluem tags para método de exibição.
É possível?
Solução
Desde 2.4, saída XML tem sido suportado. Veja por exemplo neste blog por um dos mantenedores:
geradores de HTML e XML mudou-se para unmaintained
- No gem será fornecido como é muito difícil fazê-los funcionar
- opções de-um-arquivo removido, de estilo =, - inline-fonte, -promiscuous, -op-name
Eu não acho que você pode estar executando 2.4.3 - as opções que você especificar no seu exemplo não funcionam para esta versão. Eu apenas o download do mais recente jóia e confirmou isso:
$ rdoc --format=xml --opname=api.xml
invalid argument: --format=xml
Talvez você tenha uma versão mais antiga do rdoc
instalado que aparece mais cedo em sua $PATH
?
Eu tentei rdoc 1.0.1
e tem o comportamento que você descrever (saída XML, há métodos). Portanto, parece que a resposta à sua pergunta é "não, não é possível (foi de buggy, agora não suportado)".
Você poderia tentar sugerindo este como um recurso pedido , embora parece que não é vai acontecer por um tempo, se alguma vez.