我正在使用 Doxygen 为我的 C 源代码生成文档。以下是我正在考虑的由 Doxygen 生成的乳胶文件之一的示例:
\doxysubsection{Function Documentation}
\mbox{\Hypertarget{gpio_8h_a04ac2ac79ab015b2d8d0fe82a498e183}\label{gpio_8h_a04ac2ac79ab015b2d8d0fe82a498e183}}
\index{gpio.h@{gpio.h}!gpioDeInit@{gpioDeInit}}
\index{gpioDeInit@{gpioDeInit}!gpio.h@{gpio.h}}
\doxysubsubsection{\texorpdfstring{gpioDeInit()}{gpioDeInit()}}
{\footnotesize\ttfamily void gpio\+De\+Init (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}
Desc\+: disables clock of all the G\+P\+IO ports.
问题在于 doxysubsection“函数文档”和 doxysubsubsection“gpioDeInit()”之间的行距。间距太大,导致文档不好看。我尝试使用 \titlespacing 的不同形式,如下所示:
\titlespacing\section{0pt}{6pt plus 2pt minus 2pt}{0pt plus 2pt minus 2pt}
\titlespacing\subsection{0pt}{2pt plus 0pt minus 0pt}{0pt plus 0pt minus 0pt}
\titlespacing\subsubsection{0pt}{1pt plus 0pt minus 0pt}{0pt plus 0pt minus 0pt}
%\titlespacing{\doxysection}{0pt}{*4}{*1.5}
%\titlespacing{\doxysubsection}{0pt}{*2}{*1.5}
%\titlespacing{\doxysubsubsection}{0pt}{*1}{*1.5}
%\titlespacing{\section}{0pt}{*0}{*0}
%\titlespacing{\subsection}{0pt}{*0}{*0}
%\titlespacing{\subsubsection}{0pt}{*0}{*0}
以上方法似乎都不起作用。
任何帮助都将不胜感激。另一个问题是索引页的生成,这似乎是 doxygen 的问题。它为同一实体生成多个索引条目。但目前仍然可以忽略这一点。