2017-06-27 18 views
1

私のプロジェクトでsvnキーワード($ Author $、...)を使用しています。ドキュメントを改善するためにdoxygenのコメントも使用しています。両方の組み合わせが私のためにいくつかの問題を引き起こしています。
簡体例:SVNキーワードがdoxygenに表示されます

/** 
* @author  $Author$ 
*/ 

@authorはdoxygenをキーワードと$著者$はSVNのキーワードです。 doxygen-htmlの出力は次のようになります。

これを正しく行うにはどうすればよいですか?私は私のdoxygenのドキュメントでsvn-keywordsを見たくありません。

答えて

1

は、私はこれを含んでバージョン管理テンプレートdoxygenの(doxy.in)ファイルを持っている:

/** 
* @author  $Author$ 
*/ 

私は私のドキュメント(make doc)を構築するために行く、私のスクリプト最初のSubWCRevを呼び出して、これらのキーワードのすべてのインスタンスをSVNキーワードに置き換えます。これを使ってバージョン管理されていないdoxygenファイルdoxy.outを作成し、doxygenに渡してドキュメントを作成します。

+1

あなたはまだ回答を選択していないことに気付きました。それが役に立ったら、私は最近、Cmake [** here **](https://stackoverflow.com/questions/33209705/how-to-version-control-out-of-source)を使って同様の質問に良い答えを書いた-build-directory-using-cmake-and-svn/45198417#45198417)を参照してください。参照される関数は 'svn info'の出力を使って情報をソースコードに埋め込みます。 – Stewart

1

SVNキーワードは、特定の文字列が展開されたキーワードであり、「通常の」行ではないことを明確にする方法で展開されます。つまり、拡張キーワードには常にドル記号とキーワードの名前が含まれます。この理由の1つは、自動生成されたキーワード生成コンテンツと生成されていないコンテンツの混同を避けることです。

ただし、拡張キーワードを含む行を再フォーマットするようにDoxygenを設定できるはずです。たとえば、行の中で$Author: CONTENT $を探して、HTML出力のように再フォーマットします。私は過去に何をやったか

関連する問題