Razvalyaev
3fb3058a30
- максимально убрана зависимость от HAL - можно использовать и без него, чисто на cmsis - документирован uart - документирован spi - добавлены примеры использования в general_periph - всякие фиксы документации
303 lines
8.8 KiB
TeX
303 lines
8.8 KiB
TeX
% Handle batch mode
|
|
% to overcome problems with too many open files
|
|
\let\mypdfximage\pdfximage\def\pdfximage{\immediate\mypdfximage}
|
|
\RequirePackage{iftex}
|
|
\ifLuaTeX
|
|
\directlua{pdf.setminorversion(7)}
|
|
\fi
|
|
\ifXeTeX
|
|
\special{pdf:minorversion 7}
|
|
\fi
|
|
\ifPDFTeX
|
|
\pdfminorversion=7
|
|
\fi
|
|
% Set document class depending on configuration
|
|
\documentclass[twoside]{book}
|
|
%% moved from doxygen.sty due to workaround for LaTex 2019 version and unmaintained tabu package
|
|
\usepackage{ifthen}
|
|
\ifx\requestedLaTeXdate\undefined
|
|
\usepackage{array}
|
|
\else
|
|
\usepackage{array}[=2016-10-06]
|
|
\fi
|
|
%%
|
|
% Packages required by doxygen
|
|
\makeatletter
|
|
\providecommand\IfFormatAtLeastTF{\@ifl@t@r\fmtversion}
|
|
% suppress package identification of infwarerr as it contains the word "warning"
|
|
\let\@@protected@wlog\protected@wlog
|
|
\def\protected@wlog#1{\wlog{package info suppressed}}
|
|
\RequirePackage{infwarerr}
|
|
\let\protected@wlog\@@protected@wlog
|
|
\makeatother
|
|
\IfFormatAtLeastTF{2016/01/01}{}{\usepackage{fixltx2e}} % for \textsubscript
|
|
\ifPDFTeX
|
|
\IfFormatAtLeastTF{2015/01/01}{\pdfsuppresswarningpagegroup=1}{}
|
|
\fi
|
|
\usepackage{doxygen}
|
|
\usepackage{graphicx}
|
|
\iftutex
|
|
\usepackage{fontspec}
|
|
\defaultfontfeatures{Ligatures={TeX}}
|
|
\usepackage{unicode-math}
|
|
\else
|
|
\usepackage[utf8]{inputenc}
|
|
\fi
|
|
\usepackage{makeidx}
|
|
\PassOptionsToPackage{warn}{textcomp}
|
|
\usepackage{textcomp}
|
|
\usepackage[nointegrals]{wasysym}
|
|
\usepackage{ifxetex}
|
|
% NLS support packages
|
|
% Define default fonts
|
|
% Font selection
|
|
\iftutex
|
|
\else
|
|
\usepackage[T1]{fontenc}
|
|
\fi
|
|
% set main and monospaced font
|
|
\usepackage[scaled=.90]{helvet}
|
|
\usepackage{courier}
|
|
\renewcommand{\familydefault}{\sfdefault}
|
|
\doxyallsectionsfont{%
|
|
\fontseries{bc}\selectfont%
|
|
\color{darkgray}%
|
|
}
|
|
\renewcommand{\DoxyLabelFont}{%
|
|
\fontseries{bc}\selectfont%
|
|
\color{darkgray}%
|
|
}
|
|
\newcommand{\+}{\discretionary{\mbox{\scriptsize$\hookleftarrow$}}{}{}}
|
|
% Arguments of doxygenemoji:
|
|
% 1) ':<text>:' form of the emoji, already LaTeX-escaped
|
|
% 2) file with the name of the emoji without the .png extension
|
|
% in case image exist use this otherwise use the ':<text>:' form
|
|
\newcommand{\doxygenemoji}[2]{%
|
|
\IfFileExists{./#2.png}{\raisebox{-0.1em}{\includegraphics[height=0.9em]{./#2.png}}}{#1}%
|
|
}
|
|
% Page & text layout
|
|
\usepackage{geometry}
|
|
\geometry{%
|
|
a4paper,%
|
|
top=2.5cm,%
|
|
bottom=2.5cm,%
|
|
left=2.5cm,%
|
|
right=2.5cm%
|
|
}
|
|
\usepackage{changepage}
|
|
% Allow a bit of overflow to go unnoticed by other means
|
|
\tolerance=750
|
|
\hfuzz=15pt
|
|
\hbadness=750
|
|
\setlength{\emergencystretch}{15pt}
|
|
\setlength{\parindent}{0cm}
|
|
\newcommand{\doxynormalparskip}{\setlength{\parskip}{3ex plus 2ex minus 2ex}}
|
|
\newcommand{\doxytocparskip}{\setlength{\parskip}{1ex plus 0ex minus 0ex}}
|
|
\doxynormalparskip
|
|
% Redefine paragraph/subparagraph environments, using sectsty fonts
|
|
\makeatletter
|
|
\renewcommand{\paragraph}{%
|
|
\@startsection{paragraph}{4}{0ex}{-1.0ex}{1.0ex}{%
|
|
\normalfont\normalsize\bfseries\SS@parafont%
|
|
}%
|
|
}
|
|
\renewcommand{\subparagraph}{%
|
|
\@startsection{subparagraph}{5}{0ex}{-1.0ex}{1.0ex}{%
|
|
\normalfont\normalsize\bfseries\SS@subparafont%
|
|
}%
|
|
}
|
|
\makeatother
|
|
\makeatletter
|
|
\newcommand\hrulefilll{\leavevmode\leaders\hrule\hskip 0pt plus 1filll\kern\z@}
|
|
\makeatother
|
|
% Headers & footers
|
|
\usepackage{fancyhdr}
|
|
\pagestyle{fancyplain}
|
|
\renewcommand{\footrulewidth}{0.4pt}
|
|
\fancypagestyle{fancyplain}{
|
|
\fancyhf{}
|
|
\fancyhead[LE, RO]{\bfseries\thepage}
|
|
\fancyhead[LO]{\bfseries\rightmark}
|
|
\fancyhead[RE]{\bfseries\leftmark}
|
|
\fancyfoot[LO, RE]{\bfseries\scriptsize Generated by Doxygen }
|
|
}
|
|
\fancypagestyle{plain}{
|
|
\fancyhf{}
|
|
\fancyfoot[LO, RE]{\bfseries\scriptsize Generated by Doxygen }
|
|
\renewcommand{\headrulewidth}{0pt}
|
|
}
|
|
\pagestyle{fancyplain}
|
|
\renewcommand{\chaptermark}[1]{%
|
|
\markboth{#1}{}%
|
|
}
|
|
\renewcommand{\sectionmark}[1]{%
|
|
\markright{\thesection\ #1}%
|
|
}
|
|
% ToC, LoF, LoT, bibliography, and index
|
|
% Indices & bibliography
|
|
\usepackage[numbers]{natbib}
|
|
\usepackage[titles]{tocloft}
|
|
\setcounter{tocdepth}{3}
|
|
\setcounter{secnumdepth}{5}
|
|
% creating indexes
|
|
\makeindex
|
|
\ifPDFTeX
|
|
\usepackage{newunicodechar}
|
|
\makeatletter
|
|
\def\doxynewunicodechar#1#2{%
|
|
\@tempswafalse
|
|
\edef\nuc@tempa{\detokenize{#1}}%
|
|
\if\relax\nuc@tempa\relax
|
|
\nuc@emptyargerr
|
|
\else
|
|
\edef\@tempb{\expandafter\@car\nuc@tempa\@nil}%
|
|
\nuc@check
|
|
\if@tempswa
|
|
\@namedef{u8:\nuc@tempa}{#2}%
|
|
\fi
|
|
\fi
|
|
}
|
|
\makeatother
|
|
\doxynewunicodechar{⁻}{${}^{-}$}% Superscript minus
|
|
\doxynewunicodechar{²}{${}^{2}$}% Superscript two
|
|
\doxynewunicodechar{³}{${}^{3}$}% Superscript three
|
|
\fi
|
|
% Hyperlinks
|
|
% Hyperlinks (required, but should be loaded last)
|
|
\ifPDFTeX
|
|
\usepackage[pdftex,pagebackref=true]{hyperref}
|
|
\else
|
|
\ifXeTeX
|
|
\usepackage[xetex,pagebackref=true]{hyperref}
|
|
\else
|
|
\ifLuaTeX
|
|
\usepackage[luatex,pagebackref=true]{hyperref}
|
|
\else
|
|
\usepackage[ps2pdf,pagebackref=true]{hyperref}
|
|
\fi
|
|
\fi
|
|
\fi
|
|
\hypersetup{%
|
|
colorlinks=true,%
|
|
linkcolor=blue,%
|
|
citecolor=blue,%
|
|
unicode,%
|
|
pdftitle={My\+Libs},%
|
|
pdfsubject={Расширенные библиотеки для STM32}%
|
|
}
|
|
% Custom commands used by the header
|
|
% Custom commands
|
|
\newcommand{\clearemptydoublepage}{%
|
|
\newpage{\pagestyle{empty}\cleardoublepage}%
|
|
}
|
|
% caption style definition
|
|
\usepackage{caption}
|
|
\captionsetup{labelsep=space,justification=centering,font={bf},singlelinecheck=off,skip=4pt,position=top}
|
|
% in page table of contents
|
|
\IfFormatAtLeastTF{2023/05/01}{\usepackage[deeplevels]{etoc}}{\usepackage[deeplevels]{etoc_doxygen}}
|
|
\etocsettocstyle{\doxytocparskip}{\doxynormalparskip}
|
|
\etocsetlevel{subsubsubsection}{4}
|
|
\etocsetlevel{subsubsubsubsection}{5}
|
|
\etocsetlevel{subsubsubsubsubsection}{6}
|
|
\etocsetlevel{subsubsubsubsubsubsection}{7}
|
|
\etocsetlevel{paragraph}{8}
|
|
\etocsetlevel{subparagraph}{9}
|
|
% prevent numbers overlap the titles in toc
|
|
\renewcommand{\numberline}[1]{#1~}
|
|
% End of preamble, now comes the document contents
|
|
%===== C O N T E N T S =====
|
|
\begin{document}
|
|
\raggedbottom
|
|
% Titlepage & ToC
|
|
% To avoid duplicate page anchors due to reuse of same numbers for
|
|
% the index (be it as roman numbers)
|
|
\hypersetup{pageanchor=false,
|
|
bookmarksnumbered=true,
|
|
pdfencoding=unicode
|
|
}
|
|
\pagenumbering{alph}
|
|
\begin{titlepage}
|
|
\vspace*{7cm}
|
|
\begin{center}%
|
|
{\Large My\+Libs}\\
|
|
[1ex]\large 1.\+0 \\
|
|
\vspace*{1cm}
|
|
{\large Generated by Doxygen 1.14.0}\\
|
|
\end{center}
|
|
\end{titlepage}
|
|
\clearemptydoublepage
|
|
\pagenumbering{roman}
|
|
\tableofcontents
|
|
\clearemptydoublepage
|
|
\pagenumbering{arabic}
|
|
% re-enable anchors again
|
|
\hypersetup{pageanchor=true}
|
|
%--- Begin generated contents ---
|
|
\input{index}
|
|
\chapter{Topic Index}
|
|
\input{topics}
|
|
\chapter{Class Index}
|
|
\input{annotated}
|
|
\chapter{File Index}
|
|
\input{files}
|
|
\chapter{Topic Documentation}
|
|
\input{group___m_y_l_i_b_s___a_l_l}
|
|
\chapter{Class Documentation}
|
|
\input{struct_evolve_optimizer__t}
|
|
\input{struct_g_p_i_o___l_e_d_type_def}
|
|
\input{struct_g_p_i_o___switch_type_def}
|
|
\input{struct_h_f___stack_frame__t}
|
|
\input{struct_r_t_t___flash_header__t}
|
|
\input{struct_s_p_i___settings_type_def}
|
|
\input{struct_t_i_m___encoder_type_def}
|
|
\input{struct_t_i_m___settings_type_def}
|
|
\input{struct_u_a_r_t___settings_type_def}
|
|
\input{unionuint16___bit_type_def}
|
|
\input{unionuint32___bit_type_def}
|
|
\input{unionuint64___bit_type_def}
|
|
\input{unionuint8___bit_type_def}
|
|
\chapter{File Documentation}
|
|
\input{____general__flash_8h_source}
|
|
\input{bit__access_8h}
|
|
\input{bit__access_8h_source}
|
|
\input{evolve__optimizer_8h}
|
|
\input{evolve__optimizer_8h_source}
|
|
\input{general__gpio_8h}
|
|
\input{general__gpio_8h_source}
|
|
\input{general__spi_8h}
|
|
\input{general__spi_8h_source}
|
|
\input{general__tim_8h}
|
|
\input{general__tim_8h_source}
|
|
\input{general__uart_8h}
|
|
\input{general__uart_8h_source}
|
|
\input{mylibs__config_8h}
|
|
\input{mylibs__config_8h_source}
|
|
\input{mylibs__defs_8h}
|
|
\input{mylibs__defs_8h_source}
|
|
\input{mylibs__include_8h}
|
|
\input{mylibs__include_8h_source}
|
|
\input{trace_8h}
|
|
\input{trace_8h_source}
|
|
\input{trackers_8h}
|
|
\input{trackers_8h_source}
|
|
\input{mainpage_8h_source}
|
|
\input{____general__flash_8c_source}
|
|
\input{general__gpio_8c}
|
|
\input{general__gpio_8c_source}
|
|
\input{general__spi_8c}
|
|
\input{general__spi_8c_source}
|
|
\input{general__tim_8c}
|
|
\input{general__tim_8c_source}
|
|
\input{general__uart_8c}
|
|
\input{general__uart_8c_source}
|
|
%--- End generated contents ---
|
|
% Index
|
|
\backmatter
|
|
\newpage
|
|
\phantomsection
|
|
\clearemptydoublepage
|
|
\addcontentsline{toc}{chapter}{\indexname}
|
|
\printindex
|
|
% Required for some languages (in combination with latexdocumentpre from the header)
|
|
\end{document}
|