From deba85b2859d8322ecba2000fd9e561f315f9ba7 Mon Sep 17 00:00:00 2001
From: Anna Lyons <Anna.Lyons@data61.csiro.au>
Date: Wed, 9 May 2018 16:54:25 +1000
Subject: [PATCH] manual: promote sel4_arch API docs level

This change makes sel4_arch api docs the same level as the base arch api docs. This is because the
header level became too deep for latex section types, and there is not much advantage to such deep
hierarchies.
---
 manual/Makefile      |  8 +-------
 manual/parts/api.tex | 11 ++++-------
 2 files changed, 5 insertions(+), 14 deletions(-)

diff --git a/manual/Makefile b/manual/Makefile
index ba6e8714b..0ee779bca 100644
--- a/manual/Makefile
+++ b/manual/Makefile
@@ -119,15 +119,9 @@ ${DoxygenXml}/%.xml: doxygen
 	@echo "====> Generating $@"
 
 # Latex files translated from doxygen-generated xml
-# General object invocations are listed as subsections
-${GeneratedLatexDir}/ObjectApi.tex: ${DoxygenXml}/group__ObjectApi.xml
-	@echo "====> Generating $@"
-	${Q}${PYTHON} ${GenerationTool} --level 2 --input $< --output $@
-
-# Everything else is listed as subsubsections
 ${GeneratedLatexDir}/%.tex: ${DoxygenXml}/group__%.xml
 	@echo "====> Generating $@"
-	${Q}${PYTHON} ${GenerationTool} --level 3 --input $< --output $@
+	${Q}${PYTHON} ${GenerationTool} --level 2 --input $< --output $@
 
 # Collect generated latex files into single rule
 generated-latex: ${GeneratedLatexDir}/GeneralSystemCalls.tex \
diff --git a/manual/parts/api.tex b/manual/parts/api.tex
index 45317966b..a8a7c232c 100644
--- a/manual/parts/api.tex
+++ b/manual/parts/api.tex
@@ -269,16 +269,14 @@ complete the \apifunc{seL4\_Untyped\_Retype}{untyped_retype} request.
 \clearpage
 
 \section{x86-Specific Object Methods}
-
-\subsection{General x86 Object Methods}
 \inputgeneratedapidoc{ObjectApiX86}
 \clearpage
 
-\subsection{IA32-Specific Object Methods}
+\section{IA32-Specific Object Methods}
 \inputgeneratedapidoc{ObjectApiIa32}
 \clearpage
 
-\subsection{x86\_64-Specific Object Methods}
+\section{x86\_64-Specific Object Methods}
 \inputgeneratedapidoc{ObjectApiX64}
 
 \fi % xeightsix
@@ -287,15 +285,14 @@ complete the \apifunc{seL4\_Untyped\_Retype}{untyped_retype} request.
 
 \section{ARM-Specific Object Methods}
 
-\subsection{General ARM Object Methods}
 \inputgeneratedapidoc{ObjectApiArm}
 \clearpage
 
-\subsection{Aarch32-Specific Object Methods}
+\section{Aarch32-Specific Object Methods}
 \inputgeneratedapidoc{ObjectApiAarch32}
 \clearpage
 
-\subsection{Aarch64-Specific Object Methods}
+\section{Aarch64-Specific Object Methods}
 \inputgeneratedapidoc{ObjectApiAarch64}
 \clearpage