2014-07-22 15 views
6

Czy proces wprowadzania wersji zawiera nowe funkcje do specyfikacji Javadoc? Moje pytanie jest inspirowane przez pozornie nowe tagi: @apiNote, @implSpec i @implNote, które pojawiają się w dokumentach źródłowych w języku Java 8. I'm aware that these tags are not standard and subject to change - jeśli zespół Java Javy zdecydował, że te znaczniki są standardem w nowej wersji Javadoc, to gdzie deweloper może znaleźć te informacje?Czy istnieje proces wersjonowania narzędzia Javadoc?

Czytałem Oracle dokumenty odwołujące wersje javadoc począwszy od 1.1, a kończąc na 1,4, który mógłby prowadzić jeden wierzyć, że z każdej wersji Java jest nowa wersja Javadoc, ale nie mogę znaleźć żadnych dowodów poprzeć to założenie.

Jedyne uzasadnione odniesienie, jakie kiedykolwiek znalazłem, odnoszące się do specyfikacji/najlepszych praktyk Javadoc/zaakceptowanych tagów, to: How to Write Doc Comments for the Javadoc Tool.

+0

Nie wiem, dlaczego wątek e-mail nie jest wiarygodnym źródłem informacji; w nim wspomina, że ​​te znaczniki nie są standardowe i że mogą ulec zmianie. – Makoto

+1

@Makoto Punktem tego pytania nie są te znaczniki, staram się zrozumieć, jak działa wersja Javadoc i gdzie mieszka informacja o nowych funkcjach. Zaktualizowałem to pytanie, aby, mam nadzieję, rozwiązać problem zamieszania, którego doświadczyłeś. –

Odpowiedz

3

Narzędzie javadoc rzeczywiście zyskuje nowe możliwości w każdej głównej wersji Javy. Jeśli odwiedzisz http://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/ i poszukaj sekcji API Enhancements, znajdziesz linki opisujące nowe możliwości narzędzia javadoc dla każdej wersji od wersji 1.4.

+0

Dokładnie tego, czego szukałem, dzięki. –

Powiązane problemy