This is an example of a build script \#


\begin{DoxyCode}
kdb find-tools [-h] [--warnings] [--good] [--alltags] [-n NAME] [-a AUTHOR] [-d DATE]
               [-t TAGS [TAGS ...]] [-b BRIEF] [-e EXECUTE]
\end{DoxyCode}


If you are looking for a tool, then you have found the right tool to find tools! {\ttfamily kdb find-\/tools} provides search and list functionality for tools.

Just enter {\ttfamily kdb find-\/tools} to get a list of names, type and short description of all available tools.

If you are looking for something special, then there are two ways\+:


\begin{DoxyEnumerate}
\item Tag Search\+: Type {\ttfamily kdb find-\/tools -\/-\/alltags} to get a list of all Tags in use. Then you can search with {\ttfamily kdb -\/t \mbox{[}T\+A\+GS \mbox{[}T\+A\+GS ...\mbox{]}\mbox{]}}
\item Full Text Search\+:
\begin{DoxyItemize}
\item {\ttfamily kdb find-\/tools -\/n N\+A\+ME} to search for a script name.
\item {\ttfamily kdb find-\/tools -\/b B\+R\+I\+EF} to search for a short text.
\item {\ttfamily kdb find-\/tools -\/a A\+U\+T\+H\+OR} to search for an author.
\item {\ttfamily kdb find-\/tools -\/d D\+A\+TE} to search for a creation date.
\item {\ttfamily kdb find-\/tools -\/e E\+X\+E\+C\+U\+TE} to search for a type.
\end{DoxyItemize}
\end{DoxyEnumerate}

All methods can be combined. For example if you search all bash scripts which do some configuration work. You can type {\ttfamily kdb find-\/tools -\/t configuration -\/e bash}.

Meta Tags as comments in the beginning of a script are parsed. Mate Tags start with an {\ttfamily @}, here is a list of all Meta Tags\+:

\tabulinesep=1mm
\begin{longtabu} spread 0pt [c]{*{2}{|X[-1]}|}
\hline
\rowcolor{\tableheadbgcolor}\textbf{ Meta\+Tag }&\textbf{ Meaning  }\\\cline{1-2}
\endfirsthead
\hline
\endfoot
\hline
\rowcolor{\tableheadbgcolor}\textbf{ Meta\+Tag }&\textbf{ Meaning  }\\\cline{1-2}
\endhead
@author &Names and Emails (in $<$$>$) of the Authors as comma separated list \\\cline{1-2}
@brief &A Short Description (One Line!) \\\cline{1-2}
@tags &Comma Separated List of Tags \\\cline{1-2}
@date &Date when the script was created, use D\+D.\+M\+M.\+Y\+Y\+YY as format \\\cline{1-2}
\end{longtabu}
Do not mind the \textquotesingle{}\textbackslash{}\textquotesingle{} at the beginning it is a doxygen escaping.

Beware, that these metatags should be applied at the beginning of the file (in the first 10 rows)!


\begin{DoxyCode}
#!/bin/sh
#
# @author Kurt Micheli <kurt.micheli@libelektra.org>
# @date 31.10.2018
# @tags configure, build
\end{DoxyCode}


The Metatag System of Epydoc is used (\href{http://epydoc.sourceforge.net/manual-fields.html#module-metadata-variables}{\tt http\+://epydoc.\+sourceforge.\+net/manual-\/fields.\+html\#module-\/metadata-\/variables}) and extended with special tags. 