6


0

Subversionリポジトリには、doxygenがソースコードから生成するhtml、latex、manディレクトリが含まれています。 小さなソースコードの変更でさえも、新しいファイルはランダムな名前で生成されています。これはバージョン管理システムに大きな変更をもたらします。

これを回避する方法はありますか? doxygenで生成されたドキュメントを含めながら、リビジョン間の変更を最小限に抑えるにはどうすればいいですか? あるいは、どのDoxygen生成ファイルが使用されなくなったため、どのファイルを削除する必要があるのでしょうか。

1 Answer


6


私は特定の質問に対する答えを提供せずに質問に答えるのは嫌いですが、一般的にあなたのリポジトリでdoxygenのドキュメントを追跡するのは悪い考えです。 同じことがautoconfが生成したconfigureスクリプトにも当てはまります。

doxygenがないために他の人がドキュメントを生成できないのではないかと心配している場合は、あなたの言語と選択したロケールで自分のプライベートリポジトリでそれらをホストすることをお勧めします。

あなたはこれを行うように構築スクリプトを修正することができます、あまり多くの努力なしで。 何年もの間フリー/オープンソースソフトウェアに取り組んだ後の私の経験では、実際にドキュメントを気にする人はそれらを生成することができるでしょう.. しかし、あなたの走行距離は変わるかもしれません。

冗長なマージの競合を解消する Joeはコメントを* AND *ドキュメントに変更し、両方をマージしなければなりません)私見は生成されたドキュメントを外部化することを正当化します。