Okno dialogowe Położenie dokumentacji Javadoc

To okno dialogowe umożliwia zdefiniowanie położenia dokumentacji Javadoc dla pliku JAR lub projektu Java.

Okno to można wyświetlić w następujący sposób:

Wybierz plik JAR lub projekt Java, otwórz menu kontekstowe i wybierz opcję Właściwości > Położenie dokumentacji Javadoc lub użyj opcji Właściwości z menu Plik.
W kreatorze generowania dokumentacji Javadoc, na stronie Standardowe ustawienia biblioteki Doclet, wybierz opcję Konfiguruj.

Dokumentacja Javadoc może być dołączana do plików JAR, folderów klas lub projektów Java. W przypadku projektów ta dokumentacja opisuje elementy we wszystkich folderach źródłowych, a w przypadku plików JAR i folderów klas - elementy zawarte w plikach JAR. Z położenia tego korzysta:

Opcja Otwórz przyłączoną dokumentację Javadoc w menu Nawigacja w celu otwarcia przyłączonej dokumentacji Javadoc elementu.
Funkcja pomocy kontekstowej (F1), wskazująca położenie dokumentacji Javadoc.
Kreator eksportowania dokumentacji Javadoc w celu tworzenia odsyłaczy do innej dokumentacji lub jako domyślnego położenie docelowej dokumentacji projektu.

Poprawne położenia to adresy URL, które wskazują folder zawierający pliki index.html i package-list dokumentacji interfejsu API. Przykłady:

file:///M:/JAVA/JDK1.2/DOCS/API/
http://download.oracle.com/javase/6/docs/api/

Opcja	Opis	Wartość domyślna
Adres URL dokumentacji Javadoc	Umożliwia określenie położenia wygenerowanej dokumentacji Javadoc. Za pomocą przycisku Przeglądaj można wyszukać położenie dokumentacji Javadoc w lokalnym systemie plików (wynikiem będzie adres URL w postaci file://).	<puste>
Sprawdź poprawność	Umożliwia sprawdzenie poprawności bieżącego położenia przez podjęcie próby uzyskania dostępu do plików index.html i package-list o podanym adresie URL. Jeśli sprawdzenie poprawności powiedzie się, można bezpośrednio otwierać dokumentację.

Dokumentacja Javadoc dla plików JAR i folderów klas może także znajdować się wewnątrz archiwum dostępnego w lokalnym systemie plików. W takim przypadku musi zostać określone położenie archiwum, a także położenie dokumentacji wewnątrz archiwum.

Opcja	Opis	Wartość domyślna
Położenie archiwum	Umożliwia określenie położenia archiwum, które zawiera wygenerowaną dokumentację Javadoc. Przycisk Przeglądaj umożliwia przeglądanie lokalnego systemu plików w poszukiwaniu położenia dokumentacji Javadoc.	<puste>
Ścieżka w archiwum	Umożliwia określenie ścieżki wewnątrz archiwum, które zawiera wygenerowaną dokumentację Javadoc. Przycisk Przeglądaj umożliwia wyświetlenie zawartości archiwum.	<puste>
Sprawdź poprawność	Umożliwia sprawdzenie poprawności bieżącego położenia przez podjęcie próby uzyskania dostępu do plików index.html i package-list o podanym adresie URL. Jeśli sprawdzenie poprawności powiedzie się, można bezpośrednio otwierać dokumentację.