Hi everyone,

 

In Javadoc it's standard procedure to document generic type parameters with the 
@param tag. See here: 
http://docs.oracle.com/javase/1.5.0/docs/tooldocs/solaris/javadoc.html#@param

However, doxygen doesn't seem to recognize the connection. In our build logs, I 
find messages like this:

 

warning: argument 'T' of command @param is not found in the argument list of 
de.berenbergbank.global.types.BlSelectionTable::registerBlComponent(Class< T > 
clazz, String tag, boolean mandatory, CheckInfo checkResult)

 

The full method declaration is:

 

public <T extends MemberInterface> T registerBlComponent(Class<T> clazz,

                                                           String tag,

                                                           boolean mandatory,

                                                           CheckInfo 
checkResult)

 

Obviously, T indeed exists here as a generic type parameter and should thus by 
Javadoc conventions be documented using the @param tag. Is this a known bug? 
We're using doxygen 1.7.6.1, but I found nothing like this in the changelog, so 
I'm assuming the problem might still exist.

Mit freundlichen Grüßen 

Raimund Klein

EDV / Software Entwickler

 

BERENBERG BANK

Joh. Berenberg, Gossler & Co. KG

Neuer Jungfernstieg 20

20354 Hamburg

 

Telefon +49 40 350 60-8129

Telefax +49 40 350 60-955

E-Mail raimund.kl...@berenberg.de

www.berenberg.de <outbind://75/www.berenberg.de> 

 

Sitz: Hamburg - Amtsgericht Hamburg HRA 42659


Diese Nachricht einschliesslich etwa beigefuegter Anhaenge ist vertraulich und 
kann dem Bank- und Datengeheimnis unterliegen oder sonst rechtlich geschuetzte 
Daten und Informationen enthalten. Wenn Sie nicht der richtige Adressat sind 
oder diese Nachricht irrtuemlich erhalten haben, informieren Sie bitte sofort 
den Absender über die Antwortfunktion. Anschliessend moechten Sie bitte diese 
Nachricht einschliesslich etwa beigefuegter Anhaenge unverzueglich vollstaendig 
loeschen. Das unerlaubte Kopieren oder Speichern dieser Nachricht und/oder der 
ihr etwa beigefuegten Anhaenge sowie die unbefugte Weitergabe der darin 
enthaltenen Daten und Informationen sind nicht gestattet. Wir weisen darauf 
hin, dass rechtsverbindliche Erklaerungen namens unseres Hauses grundsaetzlich 
der Unterschriften zweier ausreichend bevollmaechtigter Vertreter unseres 
Hauses beduerfen. Wir verschicken daher keine rechtsverbindlichen Erklaerungen 
per E-Mail an Dritte. Demgemaess nehmen wir per E-Mail auch keine 
rechtsverbindlichen Erklaerungen oder Auftraege von Dritten entgegen. 
Sollten Sie Schwierigkeiten beim Oeffnen dieser E-Mail haben, wenden Sie sich 
bitte an den Absender oder an i...@berenberg.de. Please refer to 
http://www.berenberg.de/my_berenberg/disclaimer_e.html for our confidentiality 
notice.

------------------------------------------------------------------------------
Everyone hates slow websites. So do we.
Make your web apps faster with AppDynamics
Download AppDynamics Lite for free today:
http://p.sf.net/sfu/appdyn_d2d_feb
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users

Reply via email to