Come aggiungere uno spazio bianco nel commento in Doxygen

Question

Mi chiedevo se ci fosse un modo per inserire uno spazio bianco nel commento in html di Doxygen? Ho cercato il manuale online e Doxygen, ma non ho trovato nulla per farlo.

Per esempio, sto cercando di aggiungere un commento come segue:

//! motor_id,   motor direction, accel,  min veloc,  max veloc\n 
//! GAUGE_MOTOR_1,  CLOCKWISE,   100,  1,    360\n 
//! GAUGE_MOTOR_2,  CLOCKWISE,   100,  1,    360\n 
//! GAUGE_MOTOR_3,  CLOCKWISE,   100,  1,    360\n 
//! GAUGE_MOTOR_4,  CLOCKWISE,   100,  1,    360\n 
//! GAUGE_MOTOR_5,  CLOCKWISE,   400,  200,   350\n 

Ma l'output HTML mostra il risultato come questo

motor_id, motor direction, accel, min veloc, max veloc 
GAUGE_MOTOR_1, CLOCKWISE, 100, 1, 360 
GAUGE_MOTOR_2, CLOCKWISE, 100, 1, 360 
GAUGE_MOTOR_3, CLOCKWISE, 100, 1, 360 
GAUGE_MOTOR_4, CLOCKWISE, 100, 1, 360 
GAUGE_MOTOR_5, CLOCKWISE, 400, 200, 350 

Lo spazio bianco tra due parole sarà shrinked a uno spazio di doxygen automaticamente. Qualcuno sa come risolvere questo problema? Questo aiuterà molto.

Grazie mille.

Answer 1

È possibile utilizzare uno

//! <pre> 
//! motor_id,   motor direction, accel,  min veloc,  max veloc 
//! GAUGE_MOTOR_1,  CLOCKWISE,   100,  1,    360 
//! GAUGE_MOTOR_2,  CLOCKWISE,   100,  1,    360 
//! GAUGE_MOTOR_3,  CLOCKWISE,   100,  1,    360 
//! GAUGE_MOTOR_4,  CLOCKWISE,   100,  1,    360 
//! GAUGE_MOTOR_5,  CLOCKWISE,   400,  200,   350 
//! </pre> 

o

//! \verbatim 
//! motor_id,   motor direction, accel,  min veloc,  max veloc 
//! GAUGE_MOTOR_1,  CLOCKWISE,   100,  1,    360 
//! GAUGE_MOTOR_2,  CLOCKWISE,   100,  1,    360 
//! GAUGE_MOTOR_3,  CLOCKWISE,   100,  1,    360 
//! GAUGE_MOTOR_4,  CLOCKWISE,   100,  1,    360 
//! GAUGE_MOTOR_5,  CLOCKWISE,   400,  200,   350 
//! \endverbatim 

Quest'ultimo sarà davvero mostrare il testo così com'è. Il primo consentirà comunque a doxygen di interpretare i comandi all'interno del blocco, preservando gli spazi.

Answer 2

In casi come questo, trovo utile utilizzare una tabella HTML e inserire il contenuto in un file separato. Ad esempio, è possibile creare un file denominato "motors.html", inserirlo in un punto in cui il doxygen è configurato per trovare i file di input e quindi utilizzare il seguente comando per includere motors.html nel codice sorgente:

@htmlinclude motors.html 

In motors.html, si potrebbe avere qualcosa lungo le seguenti linee:

<center> 
<table border="0"> 
<tr> 
    <th>motor_id</th> 
    <th>motor direction</th> 
    <th>accel</th> 
    <th>min veloc</th> 
    <th>max veloc</th> 
<tr> 
<tr> 
    <td>GAUGE_MOTOR_1</td> 
    <td>CLOCKWISE</td> 
    <td>100</td> 
    <td>1</td> 
    <td>360</td> 
</tr> 
... 
</table> 
</center> 

È possibile utilizzare un file CSS per lo stile della tabella.