c++ - \see コマンドで変換演算子を参照する

Question

ソース内の別のポイントから変換演算子を参照する際に問題があります。これは最小限の例です:

#include <string>

/*!
  Dummy struct
 */
struct A
{
    /*!
      Dummy operator.
     */
    void operator()() const {}

    /*!
      Dummy conversion operator.

      \return Nothing, really.
     */
    operator std::string() const { return std::string(); }
};

/*!
  Dummy function.

  \see A::operator()()
  \see A::operator std::string()
 */
void b()
{
    // Here I use A::operator() and A::operator std::string
    // so it would be nice to reference them in the docs.
}

functionの最初の\seeコマンドはb()機能し、結果はAHTML 出力の の演算子へのリンクになりますが、2 番目のコマンドは機能しません。

変換演算子を参照するにはどうすればよいですか?

Answer 1

これは、「役に立たない」typedefで機能するように見えるため、doxygenstringはA::string

/*!
  Dummy struct
 */
struct A
{
    typedef std::string string;

    /*!
      Dummy conversion operator.

      \return Nothing, really.
     */
    operator string() const { return std::string(); }
};

/*!
  Dummy function.

  \see A::operator string()
 */
void b();