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.
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
@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ś. –