Penurunan harga di Doxygen dengan @file

Saya mencoba mendokumentasikan beberapa templat kode sumber dengan doxygen dan penurunan harga menggunakan blok kode berpagar

~~~cpp
/// @file    filename.h
~~~

Namun Doxygen sepertinya memproses perintah @file meskipun kode kata demi kata yang menghasilkan peringatan

warning: the name `filename.h' supplied as the second argument
in the \file statement is not an input file

Apa yang saya lakukan salah?


person Aeon512    schedule 30.09.2015    source sumber


Jawaban (1)


Anda harus menghindari tanda "@". Gunakan \@file sebagai gantinya.

person gmug    schedule 27.10.2015
comment
Mengapa perlu untuk melarikan diri? Blok kode berpagar harus diperlakukan sebagai blok kode kata demi kata, artinya doxygen mengabaikan semua perintah di antaranya dan menggunakan konten yang belum diurai. - person Aeon512; 27.10.2015
comment
Jawaban ini berfungsi untuk contoh literal, tetapi tidak berfungsi untuk \@brief my brief description -- tidak akan digunakan dengan benar oleh DOxygen. Saya senasib dengan @ Aeon512 - person kayleeFrye_onDeck; 04.03.2016