Supposons que j'ai le répertoire de projet MyProject
, sous lequel j'ai le répertoire src
avec les sources du programme.
Je veux compiler tous les javadocs à partir de là. Quelle est la commande la plus simple à exécuter?
Si je cours
javadoc -sourcepath ./src -d ./docs
Je reçois une erreur
javadoc: error - No packages or classes specified.
Ne peut-il pas déduire les paquets des fichiers source?
EDIT 1
Cette façon provoque également une erreur
...MyProject>javadoc -sourcepath ./src *.Java -d ./docs
Creating destination directory: "./docs\"
javadoc: error - File not found: "*.Java"
1 error
Ce qui suit a fonctionné pour moi
javadoc -sourcepath ./src -d ./docs -subpackages .
La page de manuel indique que seuls les packages qui lui sont fournis seront explicitement documentés. Il existe une option appelée sous-packages qui documente de manière récursive le package donné et tous ses sous-packages, mais vous devez toujours spécifier tous les packages de base.
par exemple.
javadoc -d /home/html -sourcepath /home/src -subpackages Java -exclude Java.net:Java.lang
Sous Linux, cela a fonctionné pour moi quand j'ai fait ce qui suit
javadoc -d docs/ $(find . -name *.Java)
J'espère que ça aide
essayez d'utiliser javadoc -sourcepath ./src *.Java -d ./docs
La méthode la plus simple consiste à utiliser Eclipse: Projet -> GenerateJavadoc et à choisir le package/projet que vous souhaitez documenter.
Pour moi aussi ce qui suit a fonctionné:
javadoc -sourcepath ./src **/*.Java -d ./docs