1 \NeedsTeXFormat{LaTeX2e}
2 \ProvidesPackage{doxygen}
4 % Packages used by this style file
9 \RequirePackage{ifthen}
10 \RequirePackage{verbatim}
11 \RequirePackage[table]{xcolor}
12 \RequirePackage{longtable}
14 \RequirePackage{tabularx}
15 \RequirePackage{multirow}
17 %---------- Internal commands used in this style file ----------------
19 \newcommand{\ensurespace}[1]{%
21 \setlength{\dimen@}{#1}%
22 \vskip\z@\@plus\dimen@%
23 \penalty -100\vskip\z@\@plus -\dimen@%
27 \vskip\z@skip% hide the previous |\vskip| from |\addvspace|
31 \newcommand{\DoxyLabelFont}{}
32 \newcommand{\entrylabel}[1]{%
34 \parbox[b]{\labelwidth-4pt}{%
35 \makebox[0pt][l]{\DoxyLabelFont#1}%
36 \vspace{1.5\baselineskip}%
41 \newenvironment{DoxyDesc}[1]{%
42 \ensurespace{4\baselineskip}%
44 \settowidth{\labelwidth}{20pt}%
45 \setlength{\parsep}{0pt}%
46 \setlength{\itemsep}{0pt}%
47 \setlength{\leftmargin}{\labelwidth+\labelsep}%
48 \renewcommand{\makelabel}{\entrylabel}%
56 \newlength{\xreflength}
57 \newcommand{\xreflabel}[1]{%
59 \setlength{\xreflength}{\wd\xrefbox}%
60 \ifthenelse{\xreflength>\labelwidth}{%
61 \begin{minipage}{\textwidth}%
62 \setlength{\parindent}{0pt}%
63 \hangindent=15pt\bfseries #1\vspace{1.2\itemsep}%
66 \parbox[b]{\labelwidth}{\makebox[0pt][l]{\textbf{#1}}}%
70 %---------- Commands used by doxygen LaTeX output generator ----------
72 % Used by <pre> ... </pre>
73 \newenvironment{DoxyPre}{%
81 % Used by @code ... @endcode
82 \newenvironment{DoxyCode}{%
91 % Used by @example, @include, @includelineno and @dontinclude
92 \newenvironment{DoxyCodeInclude}{%
98 % Used by @verbatim ... @endverbatim
99 \newenvironment{DoxyVerb}{%
107 % Used by @verbinclude
108 \newenvironment{DoxyVerbInclude}{%
114 % Used by numbered lists (using '-#' or <ol> ... </ol>)
115 \newenvironment{DoxyEnumerate}{%
121 % Used by bullet lists (using '-', @li, @arg, or <ul> ... </ul>)
122 \newenvironment{DoxyItemize}{%
128 % Used by description lists (using <dl> ... </dl>)
129 \newenvironment{DoxyDescription}{%
135 % Used by @image, @dotfile, @dot ... @enddot, and @msc ... @endmsc
136 % (only if caption is specified)
137 \newenvironment{DoxyImage}{%
145 % Used by @image, @dotfile, @dot ... @enddot, and @msc ... @endmsc
146 % (only if no caption is specified)
147 \newenvironment{DoxyImageNoCaption}{%
154 \newenvironment{DoxyAttention}[1]{%
155 \begin{DoxyDesc}{#1}%
160 % Used by @author and @authors
161 \newenvironment{DoxyAuthor}[1]{%
162 \begin{DoxyDesc}{#1}%
168 \newenvironment{DoxyDate}[1]{%
169 \begin{DoxyDesc}{#1}%
175 \newenvironment{DoxyInvariant}[1]{%
176 \begin{DoxyDesc}{#1}%
182 \newenvironment{DoxyNote}[1]{%
183 \begin{DoxyDesc}{#1}%
189 \newenvironment{DoxyPostcond}[1]{%
190 \begin{DoxyDesc}{#1}%
196 \newenvironment{DoxyPrecond}[1]{%
197 \begin{DoxyDesc}{#1}%
203 \newenvironment{DoxyCopyright}[1]{%
204 \begin{DoxyDesc}{#1}%
210 \newenvironment{DoxyRemark}[1]{%
211 \begin{DoxyDesc}{#1}%
216 % Used by @return and @returns
217 \newenvironment{DoxyReturn}[1]{%
218 \begin{DoxyDesc}{#1}%
224 \newenvironment{DoxySince}[1]{%
225 \begin{DoxyDesc}{#1}%
231 \newenvironment{DoxySeeAlso}[1]{%
232 \begin{DoxyDesc}{#1}%
238 \newenvironment{DoxyVersion}[1]{%
239 \begin{DoxyDesc}{#1}%
245 \newenvironment{DoxyWarning}[1]{%
246 \begin{DoxyDesc}{#1}%
252 \newenvironment{DoxyInternal}[1]{%
257 % Used by @par and @paragraph
258 \newenvironment{DoxyParagraph}[1]{%
260 \settowidth{\labelwidth}{40pt}%
261 \setlength{\leftmargin}{\labelwidth}%
262 \setlength{\parsep}{0pt}%
263 \setlength{\itemsep}{-4pt}%
264 \renewcommand{\makelabel}{\entrylabel}%
271 % Used by parameter lists
272 \newenvironment{DoxyParams}[2][]{%
275 \ifthenelse{\equal{#1}{}}%
276 {\begin{longtabu} spread 0pt [l]{|X[-1,l]|X[-1,l]|}}% name + description
277 {\ifthenelse{\equal{#1}{1}}%
278 {\begin{longtabu} spread 0pt [l]{|X[-1,l]|X[-1,l]|X[-1,l]|}}% in/out + name + desc
279 {\begin{longtabu} spread 0pt [l]{|X[-1,l]|X[-1,l]|X[-1,l]|X[-1,l]|}}% in/out + type + name + desc
281 \multicolumn{2}{l}{\hspace{-6pt}\bfseries\fontseries{bc}\selectfont\color{darkgray} #2}\\[1ex]%
284 \multicolumn{2}{l}{\hspace{-6pt}\bfseries\fontseries{bc}\selectfont\color{darkgray} #2}\\[1ex]%
292 % Used for fields of simple structs
293 \newenvironment{DoxyFields}[1]{%
296 \begin{longtabu} spread 0pt [l]{|X[-1,r]|X[-1,l]|X[-1,l]|}%
297 \multicolumn{3}{l}{\hspace{-6pt}\bfseries\fontseries{bc}\selectfont\color{darkgray} #1}\\[1ex]%
300 \multicolumn{3}{l}{\hspace{-6pt}\bfseries\fontseries{bc}\selectfont\color{darkgray} #1}\\[1ex]%
308 % Used for parameters within a detailed function description
309 \newenvironment{DoxyParamCaption}{%
310 \renewcommand{\item}[2][]{##1 {\em ##2}}%
314 % Used by return value lists
315 \newenvironment{DoxyRetVals}[1]{%
318 \begin{longtabu} spread 0pt [l]{|X[-1,r]|X[-1,l]|}%
319 \multicolumn{2}{l}{\hspace{-6pt}\bfseries\fontseries{bc}\selectfont\color{darkgray} #1}\\[1ex]%
322 \multicolumn{2}{l}{\hspace{-6pt}\bfseries\fontseries{bc}\selectfont\color{darkgray} #1}\\[1ex]%
330 % Used by exception lists
331 \newenvironment{DoxyExceptions}[1]{%
334 \begin{longtabu} spread 0pt [l]{|X[-1,r]|X[-1,l]|}%
335 \multicolumn{2}{l}{\hspace{-6pt}\bfseries\fontseries{bc}\selectfont\color{darkgray} #1}\\[1ex]%
338 \multicolumn{2}{l}{\hspace{-6pt}\bfseries\fontseries{bc}\selectfont\color{darkgray} #1}\\[1ex]%
346 % Used by template parameter lists
347 \newenvironment{DoxyTemplParams}[1]{%
350 \begin{longtabu} spread 0pt [l]{|X[-1,r]|X[-1,l]|}%
351 \multicolumn{2}{l}{\hspace{-6pt}\bfseries\fontseries{bc}\selectfont\color{darkgray} #1}\\[1ex]%
354 \multicolumn{2}{l}{\hspace{-6pt}\bfseries\fontseries{bc}\selectfont\color{darkgray} #1}\\[1ex]%
362 % Used for member lists
363 \newenvironment{DoxyCompactItemize}{%
365 \setlength{\itemsep}{-3pt}%
366 \setlength{\parsep}{0pt}%
367 \setlength{\topsep}{0pt}%
368 \setlength{\partopsep}{0pt}%
373 % Used for member descriptions
374 \newenvironment{DoxyCompactList}{%
376 \setlength{\leftmargin}{0.5cm}%
377 \setlength{\itemsep}{0pt}%
378 \setlength{\parsep}{0pt}%
379 \setlength{\topsep}{0pt}%
380 \renewcommand{\makelabel}{\hfill}%
386 % Used for reference lists (@bug, @deprecated, @todo, etc.)
387 \newenvironment{DoxyRefList}{%
389 \setlength{\labelwidth}{10pt}%
390 \setlength{\leftmargin}{\labelwidth}%
391 \addtolength{\leftmargin}{\labelsep}%
392 \renewcommand{\makelabel}{\xreflabel}%
398 % Used by @bug, @deprecated, @todo, etc.
399 \newenvironment{DoxyRefDesc}[1]{%
401 \renewcommand\makelabel[1]{\textbf{##1}}%
402 \settowidth\labelwidth{\makelabel{#1}}%
403 \setlength\leftmargin{\labelwidth+\labelsep}%
409 % Used by parameter lists and simple sections
410 \newenvironment{Desc}
412 \settowidth{\labelwidth}{20pt}%
413 \setlength{\parsep}{0pt}%
414 \setlength{\itemsep}{0pt}%
415 \setlength{\leftmargin}{\labelwidth+\labelsep}%
416 \renewcommand{\makelabel}{\entrylabel}%
423 \newcommand{\PBS}[1]{\let\temp=\\#1\let\\=\temp}%
424 \newenvironment{TabularC}[1]%
426 \begin{longtabu} spread 0pt [c]{*#1{|X[-1]}|}}%
427 {\end{longtabu}\par}%
429 \newenvironment{TabularNC}[1]%
430 {\begin{tabu} spread 0pt [l]{*#1{|X[-1]}|}}%
433 % Used for member group headers
434 \newenvironment{Indent}{%
436 \setlength{\leftmargin}{0.5cm}%
438 \item[]\ignorespaces%
444 % Used when hyperlinks are turned off
445 \newcommand{\doxyref}[3]{%
446 \textbf{#1} (\textnormal{#2}\,\pageref{#3})%
449 % Used to link to a table when hyperlinks are turned on
450 \newcommand{\doxytablelink}[2]{%
454 % Used to link to a table when hyperlinks are turned off
455 \newcommand{\doxytableref}[3]{%
460 \newcommand{\lcurly}{\{}
461 \newcommand{\rcurly}{\}}
463 % Colors used for syntax highlighting
464 \definecolor{comment}{rgb}{0.5,0.0,0.0}
465 \definecolor{keyword}{rgb}{0.0,0.5,0.0}
466 \definecolor{keywordtype}{rgb}{0.38,0.25,0.125}
467 \definecolor{keywordflow}{rgb}{0.88,0.5,0.0}
468 \definecolor{preprocessor}{rgb}{0.5,0.38,0.125}
469 \definecolor{stringliteral}{rgb}{0.0,0.125,0.25}
470 \definecolor{charliteral}{rgb}{0.0,0.5,0.5}
471 \definecolor{vhdldigit}{rgb}{1.0,0.0,1.0}
472 \definecolor{vhdlkeyword}{rgb}{0.43,0.0,0.43}
473 \definecolor{vhdllogic}{rgb}{1.0,0.0,0.0}
474 \definecolor{vhdlchar}{rgb}{0.0,0.0,0.0}
476 % Color used for table heading
477 \newcommand{\tableheadbgcolor}{lightgray}%