Conexiones Javadoc

org.eclipse.pde.core.javadoc

3.2

Este punto de extensión asocia plug-ins con la ubicación javadoc del código que contienen. PDE utiliza estas correlaciones para conectar un javadoc automáticamente a bibliotecas de plug-in cuando calcula una vía de acceso de clases de plug-in.

<!ELEMENT extension (javadoc+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT javadoc (plugin+)>

<!ATTLIST javadoc

path    CDATA #REQUIRED

archive (true | false) "false">


<!ELEMENT plugin EMPTY>

<!ATTLIST plugin

id CDATA #REQUIRED>


Este es un ejemplo de la extensión javadoc:
 

<extension point=

"org.eclipse.pde.core.javadoc"

>

<javadoc path=

"doc.zip!/references/api/"

archive=

"true"

/>

<plugin id=

"com.example.abc"

/>

<plugin id=

"com.example.def"

/>

</javadoc>

<javadoc path=

"http://www.sample-url.org/doc/"

/>

<plugin id=

"com.example.ghi"

/>

</javadoc>

<javadoc path=

"doc/"

/>

<plugin id=

"com.example.jkl"

/>

</javadoc>

</extension>

En este ejemplo, javadoc para dos plug-ins, com.example.abc y com.example.xyz tienen los javadocs ubicados en un directorio references/api/ dentro de un archivo zip doc.zip en el plug-in que declara esta extensión. El javadoc para el plug-in com.example.ghi está ubicado en http://www.sample-url.org/doc/. El javadoc del plug-in com.example.jkl está ubicado en el directorio doc relativo a la ubicación del plug-in que declara esta extensión.

No es necesario código Java para este punto de extensión.

Eclipse SDK viene con los plug-ins de documentación ISV que utilizan este punto de extensión.