Pregunta
Estoy intentando generar un RDoc usando el formato XML. Aquí está el comando que estoy usando:
$ rdoc --fmt=xml --opname=api.xml
El archivo se crea pero no se genera ninguna lista de métodos. Estoy usando rdoc (2.4.3)
. La plantilla RDoc para XML incluye etiquetas para la visualización del método.
¿Es posible?
Solución
Desde 2.4, la salida XML no ha sido compatible. Ver por ejemplo este blog por uno de los mantenedores:
Se movieron los generadores de HTML y XML a no mantenidos
- No se proporcionará ninguna gema porque es demasiado difícil hacer que funcionen
- Opciones eliminadas: un archivo, —style =, - inline-source, —promiscuous, —op-name
No creo que pueda estar ejecutando 2.4.3: las opciones que especifique en su ejemplo no funcionan para esta versión. Acabo de descargar la última gema y confirmé esto:
$ rdoc --format=xml --opname=api.xml
invalid argument: --format=xml
¿Quizás tiene una versión anterior de rdoc
instalada que aparece anteriormente en su $ PATH
?
Intenté rdoc 1.0.1
y obtuve el comportamiento que describiste (salida XML, sin métodos). Por lo tanto, parece que la respuesta a tu pregunta es " no, no es posible (estaba defectuoso, ahora no es compatible) " ;.
Puede intentar sugerir esto como una solicitud de funciones , aunque suena como si no va a suceder por un tiempo, si alguna vez.