Niektóre z komentarzy lub opisów znajdujących się w pliku źródłowym programu technologicznego mogą być na tyle uniwersalne, że można je chcieć zawrzeć również w dokumentacji do innych programów. Zbieraniem takich właśnie komentarzy służy sekcja komentarzy dołączalnych. Początek tej sekcji wyznacza ciąg znaków:
/*!includable = nazwa_sekcji - start */
lub:
<!-- includable = nazwa_sekcji - start -->
Ciąg znaków
nazwa_sekcji należy w powyższym przykładzie zamienić na nazwę identyfikującą dany komentarz w ramach danego pliku. Musi być ona unikalna w danym pliku, jednak nic nie stoi na przeszkodzie, aby sekcje o tej samej nazwie były umieszczany w różnych plikach.
Obydwie postacie przedstawione w powyższym przykładzie są równoważne, różnica między nimi
polega jedynie na wygodzie korzystania - z pierwszej
postaci wygodniej jest korzystać gdy wstawiana sekcja
komentarzy dołączalnych znajduje się bezpośrednio w
kodzie programu C, a z drugiej, gdy znajduje się ona np.
wewnątrz sekcji komentarza ogólnego.
Koniec sekcji komentarzy dołączalnych wyznacza ciąg znaków:
/*!includable - stop */
lub:
<!-- includable - stop -->
Pod względem składni komentarzy sekcja komentarzy
dołączalnych jest identyczna z sekcją komentarza
ogólnego (opis:
Sekcja 13.2.10). Jeśli
dana sekcja znajduje się w sekcji komentarza ogólnego,
jest ona widoczna w pliku wynikowym tak, jak pozostała
część komentarza. Jednak jeśli sekcja komentarzy
dołączalnych znajduje się w innym miejscu pliku, nie
będzie ona widoczna, jeśli w sekcji komentarza ogólnego
nie zostanie explicite dołączona. Sposób włączania sekcji komentarzy dołączalnych do sekcji komentarza ogólnego w innych plikach opisano w części
Sekcja 13.2.12.