Doxygen: Enum-Felder Gemeinsamkeiten dokumentieren

OP #6136099
Guten Morgen,

ich bin gerade dabei, Teile eines alten Projektteils in Doxygen zu 
übernehmen. Dabei gibt es ein großes Enum (Offset-Tabelle), bei dem oft 
mehre Felder hintereinander Gemeinsamkeiten haben, aber natürlich auch 
Einzel-Eigenschaften:
1
    /** Font header data offsets:
2
       All Font header data is uncompressed */
3
    enum u8g2_font_header_offset_e
4
    {
5
        u8g2_font_header_offset_number_of_glyphs = 0,
6
        u8g2_font_header_offset_bounding_box_mode = 1,
7
        u8g2_font_header_offset_bits_per_0 = 2,            /**< Encoding run lenght (Zeros) */
8
        u8g2_font_header_offset_bits_per_1 = 3,            /**< Encoding run lenght (Ones) */
9

10
        /* Encoding lengths of glyph bounding box components */
11
        u8g2_font_header_offset_bits_per_char_width = 4,
12
        u8g2_font_header_offset_bits_per_char_height = 5,
13
        u8g2_font_header_offset_bits_per_char_x = 6,
14
        u8g2_font_header_offset_bits_per_char_y = 7,
15
        u8g2_font_header_offset_bits_per_delta_x = 8,
16

17
        /* Font Bounding box; bytes are int8_t */
18
        u8g2_font_header_offset_max_char_width = 9,
19
        u8g2_font_header_offset_max_char_height = 10,
20
        u8g2_font_header_offset_x_offset = 11,
21
        u8g2_font_header_offset_y_offset = 12,
22

23
        /* Ascent and Descent of selected characters 'A', 'g' and '(' for specifc
24
           calculation of line pitch
25
           bytes are int8_t */
26
        u8g2_font_header_offset_ascent_A = 13,
27
        u8g2_font_header_offset_descent_g = 14,
28
        u8g2_font_header_offset_ascent_parenthesis = 15,
29
        u8g2_font_header_offset_descent_parenthesis = 16,
30

31
        /* Start Posistion (Offset) of specific Glyphs ('A', 'a', 255) in Font Array.
32
           This accelerates search for the correct glyph. Would still work, if all
33
           zeroes, thus slower */
34
        u8g2_font_header_offset_start_pos_upper_A = 17,   /**< Glyphs starting from 'A' */
35
        u8g2_font_header_offset_start_pos_lower_a = 19,   /**< Glyphs starting from 'a' */
36
        u8g2_font_header_offset_start_pos_unicode = 21,   /**< Glyphs starting from 255 */
37
    };

Bei normalen Kommentaren kann ich das ja einfach optisch gruppieren, wie 
es oben zu sehen ist. Gibt es einen Weg in Doxygen?

Antwort schreiben

Eine eigene Frage? Dieser Thread ist über 6 Jahre alt. Stell sie in einem eigenen Thread – dort lesen mehr Leute mit, und sie wird öfter und schneller beantwortet.

Neuen Thread starten

Eine Lösung, Ergänzung oder Rückmeldung zu diesem Thread? Dann antworte hier.

Formatierung
  • [c]C-Code[/c]
  • [code]Code in anderen Sprachen, ASCII-Zeichnungen[/code]
  • [math]Formel in LaTeX-Syntax[/math]
  • [[Titel]] – Link zu einem Artikel
  • Verweis auf einen anderen Beitrag: Rechtsklick auf dessen Beitrags-ID (#8078628), „Adresse kopieren“, in den Text einfügen

Mehr zur Formatierung

Längeren Sourcecode als Anhang, nicht in den Text. JPG nur für Fotos und Scans; Zeichnungen und Screenshots als PNG oder GIF. Siehe Bildformate.

Schon registriert? Anmelden

Wird nicht angezeigt. Wir schicken dir einen Link; sobald du damit bestätigst, erscheint dein Beitrag.

Mit dem Abschicken legst du einen kostenlosen Account an und erkennst die Nutzungsbedingungen und die Datenschutzerklärung an.