Doxygen - zadeklaruj parametr jako opcjonalny

Question

Dokumentuję kod używając Doxygen i zastanawiałem się, czy istnieje słowo kluczowe do deklarowania argumentu funkcji jako opcjonalnej. Coś jak:

/*! 
\fn int add(int a, int b=0) 
\brief adds two values 
\param a the first operand 
\param \optional b the second operand. Default is 0 
\return the result 
*/ 

Wygląda na to, że to powinno istnieć, ale nigdzie go nie znalazłem. Czy istnieje rzeczywista opcja, czy też muszę po prostu zanotować w opisie?

Answer 1

Aby odpowiedzieć na pytanie: Nie, nie ma czegoś takiego.

Ale nie podzielam twojej opinii, że coś takiego powinno istnieć. Wszakże deklaracja funkcji będzie wyświetlana razem z jej dokumentacją, więc każdy może zobaczyć, że b jest opcjonalny i jaki jest jego domyślny argument. I dla \fn zobacz dokumentację doxygen's discouraging the use of \fn.

Answer 2

Czego chcesz, nie jest dostarczany przez Doxygen - będziesz musiał ręcznie zanotować go w opisie.