Utilisation de LuaDoc avec des extensions autres que .lua

Question

Je développe actuellement des scripts lua pour une nouvelle application qui nécessite l'extension xx_lua. J'ai luadoc fonctionnant bien pour les extensions .lua et je sais que je pourrais simplement renommer les fichiers à l'extension lua créer les documents et les renommer, mais personnellement je préférerais une solution plus élégante.

Il est possible d'obtenir luadoc pour voir d'autres extensions. Je l'ai essayé d'appeler

luadoc_start *.xx_lua 

mais que les résultats sans sortie, même quand il y a beaucoup de fichiers dans le chemin avec cette extension.

Answer 1

Si la modification de luadoc est une option, vous pouvez le faire. Je viens d'avoir un coup d'œil à la version 3.0.1 (dernière au moment de la rédaction du présent) et dans src/luadoc/taglet/standard.lua il n'y a ligne 406:

local patterns = { "%.lua$", "%.luadoc$" } 

Le modèle "% .lua" est utilisé à deux autres endroits (même fichier, ligne 316) et dans src/luadoc/doclet/html.lua: 53, ce dernier ne semble pas pertinent. La bonne chose à faire à mon avis serait de créer un paramètre global pour l'extension du nom de fichier et de l'utiliser à la place du ".lua" codé en dur. Peut-être que vous pouvez même soumettre un correctif à luadoc et l'améliorer pour les futurs programmeurs dans votre situation :)