documentazione dopo che i membri in pitone (con doxygen)

Question

sto usando Doxygen e hanno il seguente codice:

def __init__(self): 
    ''' 

    ''' 
    if not '_ready' in dir(self) or not self._ready: 
     self._stream = sys.stderr ##!< stream to which all output is written 
     self._ready = True   ##!< @internal Flag to check initialization of singelton 

Per qualche ragione mi dice che doxygen self._stream (Member _stream) è senza documenti. posso documentarlo con un commento, come il doxygen docu descrive ain Putting documentation after members e se sì, che cosa è nel modo giusto?

** Edit: ** Questo sembra essere correlato a me non avendo nuova linea, per esempio qui:

class escapeMode(object): 
    ''' 
    Enum to represent the escape mode. 
    ''' 
    ALLWAYS  = 1  ##!< Escape all values 
    NECESSARY = 2  ##!< Escape only values containing seperators or starting with quotation 

Doxygen lamenta solo di ALLWAYS essendo privi di documenti, vorrei evitare di inserire nuove righe dietro ogni nuovo attributo Documento in questo modo poiché distrugge il valore di newline per separare i blocchi logici come loop o se istruzioni dal codice circostante

Answer 1

Questo non è attualmente supportato in doxygen, come precedentemente risposto here. Se si mette il commento sulla linea precedente che funzionerà bene:

class escapeMode(object): 
    ''' 
    Enum to represent the escape mode. 
    ''' 
    ## Escape all values 
    ALLWAYS  = 1 
    ## Escape only values containing seperators or starting with quotation 
    NECESSARY = 2 

speranza che non è troppo tardi ...