2013-08-01 10 views

Odpowiedz

9

Znacznik @since powinny być stosowane w celu określenia, która wersja została dodana metoda, klasa, itd. To jest twoja wskazówka dla innych programistów, którzy powinny tylko spodziewać się, że metoda działa w stosunku do konkretnej wersji pakietu w wersji . Uważałbym te ważne za ważne części dokumentacji , jeśli przesyłasz swój kod jako bibliotekę przeznaczoną dla kogoś innego.

/** 
* @author Firstname Lastname <address @ example.com> 
* @version 1.6  (current version number of program) 
* @since  1.5  (the version of the package this class was first added to) 
*/ 

Więcej informacji na stronie:

http://en.wikipedia.org/wiki/Javadoc

javadoc: @version and @since

+0

dziękuję, byłem zdezorientowany, ponieważ na wiki, podanym przykładem była wersja pakietu podobna do daty! – Don

+0

Wikipedia nie jest odniesieniem normatywnym. Skorzystaj z dostarczonego materiału referencyjnego. – EJP

3

Znacznik @since nie służy do daty raczej służy do przekazywania informacji o ostatniej informacji o wersji

/**  
* @since 1.7 
*/ 
2

@since 1,1

ponieważ następuje numer, który wskazuje określić jakiś rodzaj ID wersji. Każdy format będzie zrobić, ale Format NN jest korzystne

1

@since adnotacja jest używany do opisania, gdy funkcjonalność pierwszy istniał, to numer wersji.

1

Wiem, że @Since służy do wskazania wersji, która rozpoczyna pewną implementację.

@Since 1.0 // meaning is this method start from version 1.0