TR-42 / minishell

https://tr-42.github.io/minishell/
0 stars 0 forks source link

Setup doxygen #16

Closed TetsuOtter closed 1 year ago

TetsuOtter commented 1 year ago

ドキュメントを生成するツールであるDoxygenを導入してみました。 mainブランチへのpushをトリガーにGitHub Actionsで自動的に生成され、https://tr-42.github.io/minishell/index.html から閲覧可能になります。

Doxygen向けにコメントを書けば、もちろんページにも反映されます。 積極的にコメントを書いて頂けるとコード理解の補助になるので良いのですが、もちろん強制はしませんし、私自身も面倒なので気が向いたやつにだけやるつもりです。 (ぜひ全部に書いてほしい! とのことであれば、頑張って書いていきます。)

表示例

Screenshot 2023-05-20 at 19 31 21

TetsuOtter commented 1 year ago

@paphio-kitsuki

なるほど!了解しました! 使い道がいまいち分からないのですが、とりあえずいつも通りの方法でコメントを書けば良いのでしょうか?

いつもの方法でも問題ないです! ただ、通常の記法だとdoxygenが読み取ってくれないので、ドキュメントに反映させるにはdoxygen用の記法でコメントを書く必要があります。

参考: https://www.mathkuro.com/c-cpp/doxygen/#toc2