Question
J'essaie de générer un RDoc en utilisant le format XML. Voici la commande que j'utilise:
$ rdoc --fmt=xml --opname=api.xml
Le fichier est créé mais aucune liste de méthodes n'est générée. J'utilise rdoc (2.4.3)
. Le modèle RDoc pour XML inclut des balises pour l’affichage de la méthode.
Est-ce possible?
La solution
Depuis la version 2.4, la sortie XML n’est plus prise en charge. Voir par exemple ce blog par l'un des responsables:
Déplacement des générateurs HTML et XML vers des sites non maintenus
- Aucun bijou ne sera fourni car il est trop difficile de les faire fonctionner
- Options supprimées: un fichier, —style =, - source-en-ligne, —promiscuité, —nom_op
Je ne pense pas que vous puissiez exécuter 2.4.3 - les options que vous spécifiez dans votre exemple ne fonctionnent pas pour cette version. Je viens de télécharger le dernier bijou et je l’ai confirmé:
$ rdoc --format=xml --opname=api.xml
invalid argument: --format=xml
Peut-être qu'une version plus ancienne de rdoc
est-elle déjà installée dans votre $ PATH
?
J'ai essayé rdoc 1.0.1
et j'ai le comportement que vous décrivez (sortie XML, pas de méthode). Il semble donc que la réponse à votre question est "non, ce n’est pas possible (était bogué, maintenant pas pris en charge)".
Vous pouvez essayer de suggérer ceci en tant que demande de fonctionnalité , bien que cela ne semble pas être le cas. va se passer pendant un certain temps, si jamais.