2016-11-26 1 views
1

J'ai cette classe dans un fichier appelé test.java:Liens vers javadocs existants ne fonctionne que pour les packages Java Platform

import java.nio.ByteBuffer; 
import io.netty.buffer.ByteBuf; 

public class test { 
    public ByteBuffer x; 
    public ByteBuf y; 
} 

Je produis mes javadocs comme ceci:

javadoc -link http://docs.oracle.com/javase/7/docs/api/ -link http://netty.io/4.0/api/ test.java 

liens uniquement aux classes à partir de Java Les paquets de plate-forme sont créés, il n'y a pas de liens vers des classes de Netty ou d'autres paquets que j'ai essayés:

Javadocs with link option

Comment faire javadoc créer des liens vers d'autres paquets aussi bien?


Sur la page de manuel de javadoc il est dit que le seul fichier qui est vraiment nécessaire est le fichier package-list:

L'outil Javadoc lit les noms de paquets à partir du fichier-liste des paquets puis liens à ces paquets à cette URL. Lorsque l'outil Javadoc est exécuté, la valeur extdocURL est copiée littéralement dans les liens créés.

Pour les liens ces fichiers sont présents:

Il pourrait être pertinent que lors de la génération des javadocs sans fournir de liens comme celui-ci:

javadoc test.java 

De même, il montre que le nom de package du package Java Platform:

Javadocs without link option

Répondre

0

Avez-vous des avertissements obtenir javadoc/erreurs?

De mon côté, je vois:

$ javadoc -link http://docs.oracle.com/javase/7/docs/api/ -link http://netty.io/4.0/api/ test.java 
Loading source file test.java... 
Constructing Javadoc information... 
test.java:2: error: package io.netty.buffer does not exist 
import io.netty.buffer.ByteBuf; 
        ^
test.java:6: error: cannot find symbol 
    public ByteBuf y; 
     ^
    symbol: class ByteBuf 
    location: class test 
Standard Doclet version 1.8.0_111 

Si j'ajoute le pot à Netty classpath javadoc, les erreurs disparaissent et mes javadocs construites comprennent des liens vers ByteBuf:

$ javadoc -cp netty-4.0.42.Final/jar/all-in-one/netty-all-4.0.42.Final.jar -link http://docs.oracle.com/javase/7/docs/api/ -link http://netty.io/4.0/api/ test.java      
Loading source file test.java... 
Constructing Javadoc information... 
Standard Doclet version 1.8.0_111 
Building tree for all the packages and classes...