求推荐类Doxygen/Javadoc/JSDoc的BrightScript自动文档生成工具

针对BrightScript源码的自动文档生成，目前有几款工具能满足类似Doxygen、Javadoc的需求：

• BrightDoc
  这是专门为BrightScript打造的文档生成工具，支持类JSDoc的注释语法。你只需要在代码中用/** ... */格式编写包含参数、返回值、功能描述的注释块，它就能自动解析并生成美观的HTML文档。比如：

  /**
   * 计算两个数的和
   * @param a 第一个加数
   * @param b 第二个加数
   * @return 两数之和
   */
  function add(a as integer, b as integer) as integer
      return a + b
  end function
  

  它能识别函数、类、属性等元素的注释，直接输出结构化的文档。

• RokuDoc
  这款工具同样专注于Roku的BrightScript生态，支持从源码中提取注释生成文档。它支持自定义模板，你可以根据需求调整输出的文档格式，还能识别Roku特有的组件结构，适合复杂项目的文档生成。

• Doxygen（自定义适配）
  如果你已经熟悉Doxygen的使用，可以通过自定义配置来让它支持BrightScript。需要在Doxygen配置文件中添加BrightScript的语法规则，比如设置FILE_PATTERNS包含.brs文件，自定义关键字识别，虽然步骤稍繁琐，但能复用你对Doxygen的使用经验，生成符合习惯的文档。

内容的提问来源于stack exchange，提问作者Vito De Tullio