2012-03-11 18 views
9

Mam klasy jak poniżej ...javadoc wiele zmiennych w jednej linii

class A{ 

/** 
* Blah blah 
*/ 
Type1 var; 

/** 
* What do I do here? 
*/ 
Type2 var11, var12; 

} 

Jak mogę javadoc var11 i var12 jeśli oba są na tej samej linii?

Jestem ciekawy, czy to jest możliwe, wiem, że mogę umieścić je zarówno na indywidualnej linii i javadoc stamtąd.

+0

Nie. Zadeklaruj i udokumentuj pojedynczą zmienną na linię. – EJP

Odpowiedz

9

ja ciekawy więc próbuje go

/** 
* data stuff 
*/ 
int x , y ; 

Otrzymany javadoc powtarza się te same uwagi doc zarówno x jak i y. Wyobrażam sobie, że takie zachowanie byłoby przydatne, gdyby dwa pola były w zasadzie takie same z niewielkimi różnicami.

class Circle 
{ 
    .... 
    /** 
    * center coordinates 
    * The x/y coordinate of the center of this circle. 
    */ 
    int x , y ; 
+0

Tak, również doszłam do tego wniosku. Cóż, myślę, że nie ma sposobu na oddzielenie Javadoc, dzięki za odpowiedź i wysiłek! –

+0

Niestety działa to tylko z tym samym typem. Zatem linie takie jak 'private JButton testButton, JLabel testLabel;' nie będą działać. – Bowi

0

niestety nie ma sposobu, aby odróżnić oświadczenie jednej linii wielu zmiennych :(

Może to być przydatne, aby pamiętać jednak, że korzyści z tego nie pozwala na pojedynczy javadoc dostarczyć dokumentację dla zmiennych kategorycznych które w przeciwnym razie mogą się niepotrzebne linie.

/** 
* custom colors (MUST BE DISPOSED!) 
*/ 
Color lightblue, someotherblue, lightred; 

oczywiście może to być w połączeniu z inicjalizacji oraz

/** 
* These are the spec's behind batch-box font size/Height/Width 
*/ 
private int iFontHeight = 9, iboxheight = 58, iboxwidth = 125;