ドキュメント生成システム(2)

• リファレンスマニュアルの手動作成

  • 面倒くさい
    • プログラムとマニュアルで同じことを２度書くことが多い
    • プログラムの更新の度に書き換えねばならない
  • プログラムとマニュアルの乖離が多発

• 自動生成の場合

  • F90 ソースとしての可読性を低下させない
    • 原理的には、HTML でも XML でもなんでも、埋め込んで自動生成できるが…
  • 引数情報など、ソースコードをそのまま出力
    • ２度書きしたくない