Doxygen; Lokale Variablen

[Frank S. (Gast)]

Hallo allerseits,

mit Doxygen arbeite ich nun schon seit geraumer Zeit und bin eigentlich 
auch sehr zufrieden damit. Nur eine Sache hab ich bisher nie 
hinbekommen: das dokumentieren von lokalen Variablen.

Ein kl. Beispiel:

/**
  @ingroup  test
  @var      GlobaleVar
  @brief    Eine globale Variable für Doxygen
*/
unsigned int GlobaleVar = 0; 


/**
   @ingroup     test    
   @brief       Eine tolle Rechnung         
   @param       ADC_Value  Letzter Messwert des ADC
   @return      Das Ergebnis einer hoch aufwändigen Rechnung...    
*/
unsigned int Calculate(unsigned int ADC_Value)
{
  
  /** @brief Beschreibung von TempVar */
  unsigned char TempVar = 0; 
        TempVar = ADC_Value + GlobaleVar;
        // mache noch irgendwas sinnvolles mit TempVar 
        return TempVar;
}

Das dokumentieren der globalen Variablen funktioniert in diesem Beispiel 
tadellos. Das Doxygen-gerechte dokumentieren der lokalen Variable 
TempVar klappt aber absolut nicht.

Bisher hab ich u.a. noch zusätzlich folgende Variante probiert, jeweils 
innerhalb der Funktion:

///Beschreibung von TempVar 
unsigned char TempVar = 0; 


/** Beschreibung von TempVar */
unsigned char TempVar = 0; 


/**
  @var TempVar
  @brief Beschreibung von TempVar
*/
unsigned char TempVar = 0;

Nichts davon funktioniert. Wie macht ihr das? Wie beschreibt man lokale 
Variablen Doxygen-gerecht?????

Vielen Dank für alle Antworten...

Gruß
Frank

[Frank S. (Gast)]

???

[StinkyWinky (Gast)]

Frank S. schrieb:
> Wie beschreibt man lokale Variablen Doxygen-gerecht?????

Soviel ich weiss, geht das nicht mit Doxygen.

[woswasi2011 (Gast)]

Ist zwar schon etwas älter, aber eventuell gibts ja noch wen der das 
Problem hat und noch nicht gelöst hat

Alternativ kann man Variablen auch mit

uint8_t bla; //!< Variable für dieses und jenes

dokumentieren

[Michael K. (michael_k74)]

Hallo.

Hat schon jemand eine Antwort auf die Frage gefunden? Ein Workaround 
wäre auch o.K..

[Karl H. (kbuchegg)]

Die Frage, die ich mir stelle:
wozu will ich die lokale Variablen einer Funktion doxygen gerecht 
dokumentieren?

Die Variablen sind nur innerhalb der Funktion interessant, ausserhalb 
dieser Funktion benötigt sie niemand. Also brauch ich auch keine 
aufbereitete Doku dazu, denn ohne den zugrundeliegenden Algorithmus, 
sind die aus Projektsicht komplett uninteressant. Sie sind ein 
Implementierungsdetail der Funktion selber, welches sich ausserhalb der 
Funktion in keiner weise auswirkt (auswirken sollte)

  /** @brief Beschreibung von TempVar */
  unsigned char TempVar = 0;

nenn das Ding nicht TempVar sondern nenne es entsprechend seiner 
Funktion, dann ist das Dokumentation genug.

[Frank M. (aktenasche)]

jeder nachfolgende entwicklet wird sich freuen wenn die doku um etwa 
1000% anschwillt wenn man noch lokale variablem mit reinpackt...dafür 
sind kommentare da