doc: fix title levels

chipset/README.md

@@ -1,3 +1,5 @@
+#
+
 In this chapter, we first explain how Bluetooth chipsets are connected physically and then provide information about popular Bluetooth chipset and their use with BTstack.
 
 ## HCI Interface

doc/manual/docs/appendix/events_errors.md

@@ -1,3 +1,4 @@
+#
 
 ## L2CAP Events {#sec:eventsAndErrorsAppendix}
 

doc/manual/docs/architecture.md

@@ -1,3 +1,4 @@
+#
 
 As well as any other communication stack, BTstack is a collection of
 state machines that interact with each other. There is one or more state

doc/manual/docs/how_to.md

@@ -1,3 +1,4 @@
+#
 
 BTstack implements a set of Bluetooth protocols and profiles. To connect to other Bluetooth devices or to provide a Bluetooth services, BTstack has to be properly configured.
 

doc/manual/docs/integration.md

@@ -1,3 +1,4 @@
+#
 
 While the run loop provided by BTstack is sufficient for new designs,
 BTstack is often used with or added to existing projects. In this case,

doc/manual/docs/porting.md

@@ -1,3 +1,5 @@
+#
+
 In this section, we highlight the BTstack components that need to be
 adjusted for different hardware platforms.
 

doc/manual/docs/profiles.md

@@ -1,4 +1,4 @@
-
+#
 
 In the following, we explain how the various Bluetooth profiles are used
 in BTstack.

doc/manual/docs/protocols.md

@@ -1,3 +1,4 @@
+#
 
 BTstack is a modular dual-mode Bluetooth stack, supporting both
 Bluetooth Basic Rate/Enhanced Date Rate (BR/EDR) as well as Bluetooth

doc/manual/docs/quick_start.md

@@ -1,3 +1,4 @@
+# 
 
 ## General Tools
 

doc/manual/ports2markdown.py

@@ -56,9 +56,14 @@ def process_readmes(intro_file, port_folder, ports_file, ports_folder):
                 for line in fin:
                     #increase level of indentation
                     parts = re.match('#(.*)\n',line)
-                    title_parts = re.match('(#\s+)(.*)\n',line)
+
-                    if parts and title_parts:
+                    title_parts_level1 = re.match('(#\s+)(.*)\n',line)
-                        ports.write("# " + title_parts.group(2) + " {" + "#sec:" + readme_dir + "Port}\n" )
+                    title_parts_level2 = re.match('(##\s+)(.*)\n',line)
+                    
+                    if parts and title_parts_level1:
+                        ports.write("## " + title_parts_level1.group(2) + " {" + "#sec:" + readme_dir + "Port}\n" )
+                    elif parts and title_parts_level2:
+                        ports.write("### " + title_parts_level2.group(2)+ "\n" )
                     else:
                         ports.write(line)
 

doc/manual/template/examples_intro.md

@@ -1,3 +1,4 @@
+#
 
 In this section, we will describe a number of examples from the
 *example* folder. Here is a list of existing examples:

doc/manual/template/gatt_clients_intro.md

@@ -1,3 +1,4 @@
+#
 
 BTstack allows to implement and use GATT Clients in a modular way.
 

doc/manual/template/gatt_services_intro.md

@@ -1,3 +1,4 @@
+#
 
 BTstack allows to implement and use GATT Services in a modular way.
 

doc/manual/template/ports_intro.md

@@ -1 +1,3 @@
-Here is a list of existing ports:
+#
+
+## Existing ports

doc/manual/update_apis.py

@@ -100,6 +100,7 @@ def codeReference(fname, githubfolder, filepath, linenr):
 
 def writeAPI(apifile, btstackfolder, apis, mk_codeidentation):
     with open(apifile, 'w') as fout:
+        fout.write("#\n\n")
         for api_tuple in apis:
             api_filename = btstackfolder + api_tuple[0]
             api_title = api_tuple[1]

doc/manual/update_gatt_services.py

@@ -29,7 +29,7 @@ abrevations = {
 }
 
 description_template = """
-### NAME {#sec:REFERENCE}
+## NAME {#sec:REFERENCE}
 
 """