Προσαρτημένα στοιχεία 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>

Στο παράδειγμα αυτό, έχουμε το javadoc για δυο πρόσθετες λειτουργίες: την com.example.abc και την com.example.xyz, οι οποίες έχουν το javadoc σε έναν κατάλογο references/api/ εντός ενός αρχείου ZIP doc.zip στην πρόσθετη λειτουργία που δηλώνει αυτή την επέκταση. Το javadoc για την πρόσθετη λειτουργία com.example.ghi βρίσκεται στη διεύθυνση http://www.sample-url.org/doc/. Το javadoc για την πρόσθετη λειτουργία com.example.jkl βρίσκεται στον κατάλογο doc, ο οποίος είναι σχετικός με τη θέση της πρόσθετης λειτουργίας που δηλώνει αυτή την επέκταση.

Δεν απαιτείται κώδικας Java για αυτό το σημείο επέκτασης.

Το Eclipse SDK συνοδεύεται από πρόσθετες λειτουργίες τεκμηρίωσης ISV που χρησιμοποιούν αυτή την επέκταση.