Domanda
Sto provando a generare un RDoc usando il formato XML. Ecco il comando che sto usando:
$ rdoc --fmt=xml --opname=api.xml
Il file viene creato ma non viene generato alcun elenco di metodi. Sto usando rdoc (2.4.3)
. Il modello RDoc per XML include tag per la visualizzazione dei metodi.
È possibile?
Soluzione
Dal 2.4, l'output XML non è supportato. Vedi ad es. questo blog di uno dei manutentori:
Spostati generatori HTML e XML su non mantenuti
- Non verrà fornita alcuna gemma poiché è troppo difficile farle funzionare
- Opzioni rimosse — one-file, —style =, - inline-source, —promiscuous, —op-name
Non credo che tu possa eseguire 2.4.3 - le opzioni specificate nel tuo esempio non funzionano per questa versione. Ho appena scaricato l'ultima gemma e confermato questo:
$ rdoc --format=xml --opname=api.xml
invalid argument: --format=xml
Forse hai installato una versione precedente di rdoc
che appare in precedenza nel tuo $ PATH
?
Ho provato rdoc 1.0.1
e ho ottenuto il comportamento che descrivi (output XML, nessun metodo). Quindi sembra che la risposta alla tua domanda sia " no, non è possibile (era difettoso, ora non supportato) " ;.
Potresti provare a suggerirlo come richiesta di funzionalità , anche se sembra che non lo sia succederà per un po ', se mai.