Javadoc 附件

org.eclipse.pde.core.javadoc

3.2

這個延伸點在外掛程式和程式碼的 javadoc 位置之間建立關聯性。PDE 在計算外掛程式的類別路徑時,利用這些對映來自動將 javadoc 附加至外掛程式程式庫。

<!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>


下列是 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>

在此範例中,com.example.abccom.example.xyz 這兩個外掛程式的 javadoc 放在宣告此延伸規格的外掛程式的 doc.zip ZIP 檔案中的 references/api/ 目錄。外掛程式 com.example.ghi 的 javadoc 位於 http://www.sample-url.org/doc/。外掛程式 com.example.jkl 的 javadoc 位於目錄 doc,相對於宣告此延伸規格的外掛程式的位置。

這個延伸點並不需要任何 Java 程式碼。

Eclipse SDK 提供使用此延伸點的 ISV 文件外掛程式。