• ベストアンサー

Cソースを他人に委ねる方法

汚いCソースを他人にどう委ねようか悩んでます。 仕事でCソースを書いていますが、かなりサイズが大きく、古い人たちの書いたものをもとに継ぎ接ぎしたというかなり汚いソースとなっています。構造設計もなってません。挙句にドキュメントが未整理です。 これを他人に委ねるために、どのような手法が効率的でしょうか。 自分としては最低限のドキュメント(ソース解説、構造解説レベル?)を書こうかと考えているのですが、概要だけではソースを理解してもらえないし、一つ一つ解説するのも量が多いです。ソース→ドキュメントを効率的に行うツールや手法などもありませんでしょうか。

質問者が選んだベストアンサー

  • ベストアンサー
  • meeee
  • ベストアンサー率31% (6/19)
回答No.1

ツールは仕様書工房なんていかがでしょう? 仕事で使っていますが、ソースの解析に重宝しています。試用版をダウンロードできますので、一度お試しになってはいかがでしょう。 それから、引継ぎについてなのですが、想像ですが、時々保守が必要になるソースを代々引き継いでいるという感じでしょうか?改修のためには仕様についてのドキュメントが必要だと思いますが、完全に中身を理解するのは難しそうですね。 一番問題になるのは、改修後に期待通りに動作しているかですよね。改修によって、元々動いていた部分に不具合を引き起こしていないかとか。それに対しては、テスト仕様書やテストプログラムを、一緒に保守していくのが有効だと思います。 もし現在それがなければ、利用マニュアルからブラックボックステストのテスト項目を起こすのが、とりあえず早くできる方法です。 時間やコストが許せば、リファクタリングすることもあるかもしれませんから、そのときにもテスト環境が生きてきます。

参考URL:
http://www.ist.fujitsu.com/kobo/
yamaokojo2
質問者

お礼

体験版をちょこっと使ってみましたが、HTMLの出力結果がよい感じでした。 #問題の膨大な量のソースもかけてみて、そのまま仕様書としてしまおう、、、とか思いましたが、体験版のためか複数ファイルがうまく解析できませんでした。甘くはないですね^^; 同様のフリーのツールなどないものでしょうか。 ともかく保守のノウハウとともに参考にさせていただきます。ありがとうございます。

すると、全ての回答が全文表示されます。

その他の回答 (1)

  • aton
  • ベストアンサー率47% (160/334)
回答No.2

レビューが可能なら,関数呼出ツリーを作成して,あとはソースコードレビュー,というのはどうでしょうか? 関数呼出ツリー 作成ツールを含むCソースコード解析ツールは,参考URLをみると幾つかあるようです。

参考URL:
http://download.goo.ne.jp/software/category/dos/prog/c/,http://download.goo.ne.jp/software/category/win/prog/c/
すると、全ての回答が全文表示されます。

関連するQ&A