从 doxygen 输出中删除文件标签

Question

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

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

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

我的doxygen版本是1.8.14

Answer 1

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

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

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

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

/** \endcond */

更新：为了检查这是否也适用于您的情况，我分叉了 Macro Core repository on GitHub and ran doxygen (version 1.8.20) using the configuration file in the repository (I had to change some directories). The resulting doxygen documentation looked 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 */

从 doxygen 输出中删除文件标签

Remove file tags from doxygen output

doxygen