从 doxygen 输出中删除文件标签

Question

我们正在使用 doxygen（使用 EXTENSION_MAPPING = sas=Java）记录 SAS 代码，我们的 doxyfile 是 here。

问题是每个文件下都出现了一堆标签 - 根据下面突出显示的部分。

我们如何删除这些条目？有关信息，我们生成的文档托管在 here。

我的 doxygen 版本是 1.8.14

Answer 1

假设您只是将 doxygen 用于您编写的 SAS 宏的标头，您可以通过将这些部分包含在 \cond 和 \endcond 命令中来避免 doxygen 查看（部分）代码。

我在一些 SAS 项目中使用了 doxygen，宏的结构如下：

/**
   \file       sasmacro.sas
   ...  <more doxygen commands>   
*/ /** \cond */ 

%macro sasmacro(); 
    ... 
%mend; 

/** \endcond */

更新：为了检查这是否也适用于您的情况，我在 GitHub 上 fork Macro Core repository 并使用存储库中的配置文件运行 doxygen（版本 1.8.20）（我有更改一些目录）。生成的 doxygen 文档看起来像 like this。正如你在图片中看到的，我得到的标签比你多得多。我不知道为什么会这样。

之后我更改了一些宏（mf_abort、mf_existds 和 mf_getengine）。本质上，我将它们包装在@cond 和@endcond 命令中，如上图所示。顺便说一句，@ 和 \ 都应该可以工作。我使用相同的设置重新运行 doxygen，在我的情况下所有标签 are gone。

以我使用的新版 mf_existds 为例：

/**
  @file mf_existds.sas
  @brief Checks whether a dataset OR a view exists.
  @details Can be used in open code, eg as follows:

      %if %mf_existds(libds=work.someview) %then %put  yes it does!;

  NOTE - some databases have case sensitive tables, for instance POSTGRES
    with the preserve_tab_names=yes libname setting.  This may impact
    expected results (depending on whether you 'expect' the result to be
    case insensitive in this context!)

  @param libds library.dataset
  @return output returns 1 or 0
  @warning Untested on tables registered in metadata but not physically present
  @version 9.2
  @author Allan Bowe
**/ /** @cond */

%macro mf_existds(libds
)/*/STORE SOURCE*/;

  %if %sysfunc(exist(&libds)) ne 1 & %sysfunc(exist(&libds,VIEW)) ne 1 %then 0;
  %else 1;

%mend;

/** @endcond */