Связывание с существующими Javadocs работает только для пакетов Java Platform

Question

Я получил этот класс в файле с именем test.java:

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

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

Я генерировать свои Javadocs так:

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

только ссылки на классы из Java Platform созданы пакеты, нет ссылок на классы из Netty или других пакетов, которые я пробовал:

Как сделать javadoc создавать ссылки на другие пакеты?

---

На человека странице Javadoc он говорит, что единственный файл, который на самом деле требуется, это package-list файл:

Инструмент Javadoc читает имена пакетов из файла пакета-списка , а затем ссылки для этих пакетов по этому URL-адресу. Когда запускается инструмент Javadoc , значение extdocURL копируется буквально в созданные ссылки .

Для обеих ссылок эти файлы присутствуют:

• http://docs.oracle.com/javase/7/docs/api/package-list
• http://netty.io/4.0/api/package-list

Это может быть важно, что при генерации Javadocs без предоставления каких-либо ссылок, как это:

javadoc test.java 

Аналогично это показывает только имя пакета пакета Java Platform:

Answer 1

ли вы какие-либо получить JavaDoc предупреждения/ошибки?

С моей стороны, я вижу:

$ 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 

Если я добавляю Нетти баночки JavaDoc в пути к классам, ошибки уходят и мои построенные Javadocs включают ссылки на 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...