質問: 現在C言語で書かれた組み込み系ソフトウェアで記憶領域のエリアマップにエクセルを使っているのですが、肥大化してきてメンテナンス性が落ちています。 構造体のメンバーとそれぞれの用途、初期値などが書かれているファイルになります。バックアップの仕様書のようなものです。 何かツールや良い方法があれば教えていただきたいです。 軽くて見やすいものが良いですのですが、マクロを使ってエリアの自動チェックなどを行いたいので、データベースなどは避けたいです。 また、非ソフトの人間も見るので、ビジュアル化ができる方が望ましいです。 よろしくお願いします。
回答: 「記憶領域の管理」が「構造体のメンバーとそれぞれの用途、初期値」をドキュメントするという意味であれば、「doxygen」というツールが使えるかもしれません。(JavaDocを知っているのであればそれのC版のような感じです) Doxygen - Wikipedia Doxygen Doxygen: Main Page 現在ソースコードの構造体定義のコメントとExeclシートのドキュメントの2重管理をしている状態であれば、ソースコードの構造体定義のコメントのメンテナンスの一元管理にして、そこからドキュメントを作るような流れにすることが出来ます。 ソースコードの構造体定義にdoxygenで規定された書式でコメントを書いて、そこからドキュメントを作成することが出来ます。(構造体コメントをdoxygen対応にする手間はかかります。) また今回の質問内容には含まれていませんが、構造体だけでなくプログラムのほうも関数ヘッダの部分にdoxygenコメントをちゃんと書けば関数仕様もドキュメントを作成してくれます。