Clang-Docとは？ #
知名度の高いLLVM Project内の知名度の高いClang(clang tools)の知名度の低いドキュメント生成ツール。
Clang-Docがこの夏生まれ変わる #
前々から期待していたが、現状どんなもんだと思ってLLVMのフォーラムを検索していたら🔗Improve Clang-Doc Usabilityというスレッドを見つけた。
読んでいくと、どうやら GSOC project 2024でClang-Docの改善が募集されていて、contributorが決まったようだ。
🔗https://summerofcode.withgoogle.com/programs/2024/projects/QxXUJDJH
clang-docははっきり言って現状doxygenやhdoc、qdocなどのドキュメント生成ツールに比べて劣っていると思うので、改善が楽しみだ。
ASTを舐め回してファンタスティックなドキュメントを生成してくれるようになるに違いない。
まあ普通にdoxygenのUIが改善されたぐらいのものでも十分ありがたい。
ちなみに現状のclang-docの生成物はこんな感じ。
yaml, md, htmlを生成できるがこれはhtmlだ。
関係ないが-std=c++23でもclangdの補完でstd::expectedなどがエラー扱いになるので対応が待ち遠しい。
🔗https://clang.llvm.org/cxx_status.html#cxx23
gccではexpectedはすでに実装されているが、clang-18はまだなようなのでビルドできない。