code::block dziwne komentarze

Question

chodzi  o to że w codeblocku po wpisaniu // kolor tekstu zmienia się na szary no i to jest zrozumiałe bo to są znaki komentarzy ale po wpisaniu /// kolor zmienia się na ciemniejszy bardziej widoczny dlaczego? Czy to jest jakieś oznaczenie?

i jeszcze w lewym górnym rogu są dwie ikonki /** i  *< kiedy się je kliknie wychodzi coś takiego (w kolejności):

/*

* \brief 
 *
 * \param 
 * \param 
 * \return 
 *
 */

i

/**< tutaj kursor */

Answer 1

To są polecenia (znaczniki?) dla Doxygen-a - programu parsującego kod i tworzący jego dokumentacje biorąc pod uwage informacje oznaczone takimi znacznikami. Np. \brief oznacza opis (np. funkcji), a \param to opis argumentu.

Comments

Trzeba to wpisać za tymi słowami czy zamiast? I co to? /**<  */

---

/** rozpoczyna blok komentarza z instrukcjami dla doxygena z tego co kojarze. Więcej sobie doczytaj - nie orientuje się zbyt dobrze.

Answer 2

To również są komentarze które są używane do tworzenia dokumentacji programu tak aby ktoś bez czytania kodu mógł wiedzieć za co dana metoda/klasa jest odpowiedzialna.

Comments

a coś więcej???

np. po return jest co zwraca funkcja ale po brief i param