【问题标题】:Visual studio auto complete Doxygen tags for C++Visual Studio 自动完成 C++ 的 Doxygen 标签
【发布时间】:2019-03-31 07:50:00
【问题描述】:

有没有办法让 Visual Studio 自动将 doxygen 标签放在 C++ 源文件中?

我的意思是例如这段代码:

int foo(bool p);

如果我在上面输入///,Visual Studio 会自动生成以下行:

/// <summary>
/// 
/// </summary>
/// <param name="p"></param>
/// <returns></returns>
int foo(bool p);

我的问题是:是否可以对 doxygen 做同样的事情(当我输入 /** 时)?让VS生成以下内容:

   /**
    * @brief
    * @param p
    * @return
    */
    int foo(bool p)

我的问题是关于编写文档标签(不生成最终的 doxygen)。

【问题讨论】:

标签: c++ visual-studio doxygen


【解决方案1】:

VS19 中有一个设置可以做到这一点:

Tools > Options > Text Editor > C/C++ > CodeStyle > General > Generated documentation cmets style

将此设置为Doxygen (/**)

【讨论】:

  • 从 VS 16.1.3 开始,我没有看到这个选项。 C/C++ 没有“代码样式”部分。
  • 我目前正在运行 16.6.3。猜猜他们在两者之间添加了它。
  • 只是为了确认我在 VS2019 16.7.1 中有它
  • 这很有帮助,但输出仍然使用 /// 开始每一行,而不是使用星号的约定。
【解决方案2】:

我不知道为什么我在 Visual Studio Marketplace 上的搜索中没有弹出它,但它使用 /*! doxygen 标记完成了这项工作。

https://marketplace.visualstudio.com/items?itemName=dragospop.CppDoxyComplete

例子:

/*!
 * 
 * 
 * \param b
 * \return 
 */
int foo(bool b)

【讨论】:

    【解决方案3】:

    我不知道为什么我在 Visual Studio Marketplace 上的搜索中没有弹出它

    对于 VS2019 和 VS2022 版本,有基于 CppDoxyCompletion 的 another extension,但具有更多功能。

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 1970-01-01
      • 2016-09-21
      • 2017-04-20
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2020-10-09
      • 2017-11-27
      相关资源
      最近更新 更多