\label{doc_decisions_manpages_md_md_doc_decisions_manpages}%
\Hypertarget{doc_decisions_manpages_md_md_doc_decisions_manpages}%
 \hypertarget{doc_decisions_manpages_md_autotoc_md2102}{}\doxysection{Problem}\label{doc_decisions_manpages_md_autotoc_md2102}
Our manpages are written as Markdown in doc/help and then converted to roff and stored in doc/man. Storing generated files is annoying, as it requires\+:


\begin{DoxyItemize}
\item developers to always update generated files if the sources are changed
\item developers not committing irrelevant changes to generated files (e.\+g. as may occur with different CMAKE\+\_\+\+INSTALL\+\_\+\+PREFIX etc.)
\item require extra effort for continuous integration, e.\+g. \href{https://issues.libelektra.org/4542}{\texttt{ \#4542}}
\end{DoxyItemize}\hypertarget{doc_decisions_manpages_md_autotoc_md2103}{}\doxysection{Constraints}\label{doc_decisions_manpages_md_autotoc_md2103}

\begin{DoxyEnumerate}
\item we want beautiful rendered man pages
\item we cannot require rare tools for the build process
\end{DoxyEnumerate}\hypertarget{doc_decisions_manpages_md_autotoc_md2104}{}\doxysection{Assumptions}\label{doc_decisions_manpages_md_autotoc_md2104}

\begin{DoxyItemize}
\item ronn-\/ng doesn\textquotesingle{}t have packages on any distribution (violates constraint 2.)
\end{DoxyItemize}\hypertarget{doc_decisions_manpages_md_autotoc_md2105}{}\doxysection{Considered Alternatives}\label{doc_decisions_manpages_md_autotoc_md2105}

\begin{DoxyEnumerate}
\item Doxygen\+: need to be rechecked in the latest version, see \href{https://issues.libelektra.org/4551}{\texttt{ \#4551}}
\item Pandoc 2.\+9 doesn\textquotesingle{}t have the Markdown description-\/list feature like ronn-\/ng has (violates constraint 1.)
\end{DoxyEnumerate}\hypertarget{doc_decisions_manpages_md_autotoc_md2106}{}\doxysection{Decision}\label{doc_decisions_manpages_md_autotoc_md2106}
\hypertarget{doc_decisions_manpages_md_autotoc_md2107}{}\doxysection{Rationale}\label{doc_decisions_manpages_md_autotoc_md2107}
\hypertarget{doc_decisions_manpages_md_autotoc_md2108}{}\doxysection{Implications}\label{doc_decisions_manpages_md_autotoc_md2108}
\hypertarget{doc_decisions_manpages_md_autotoc_md2109}{}\doxysection{Related Decisions}\label{doc_decisions_manpages_md_autotoc_md2109}

\begin{DoxyItemize}
\item \mbox{[}\mbox{]}(doc\+\_\+decisions\+\_\+\+\_\+\+README\+\_\+md)
\item \mbox{[}\mbox{]}(doc\+\_\+decisions\+\_\+\+\_\+\+README\+\_\+md)
\item \mbox{[}\mbox{]}(doc\+\_\+decisions\+\_\+\+\_\+\+README\+\_\+md)
\end{DoxyItemize}\hypertarget{doc_decisions_manpages_md_autotoc_md2110}{}\doxysection{Notes}\label{doc_decisions_manpages_md_autotoc_md2110}
Currently no solution found, please recheck assumptions and/or check out new tools. 