From 59554fcd9331d2e0ee5e82020daae728c9044eb9 Mon Sep 17 00:00:00 2001
From: Dave Rice <dave@dericed.com>
Date: Wed, 25 Jul 2018 14:10:24 -0400
Subject: [PATCH] adjust text to move element descriptions up a level and limit
 sectional depth to 6

---
 Makefile                                |  2 +-
 matroska_schema_section_header.md       | 11 ++++-------
 transforms/ebml_schema2markdown4rfc.xsl |  4 ++--
 3 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/Makefile b/Makefile
index c3c8f383..6116bbed 100644
--- a/Makefile
+++ b/Makefile
@@ -25,7 +25,7 @@ $(OUTPUT_TAGS).md: index_tags.md tagging.md matroska_tagging_registry.md tagging
 	cat $^ > $@
 
 %.xml: %.md
-	mmark -xml2 -page $< | awk '/<?rfc toc=/ && !modif { printf("<?rfc tocdepth=\"12\"?>\n"); modif=1 } {print}' > $@
+	mmark -xml2 -page $< | awk '/<?rfc toc=/ && !modif { printf("<?rfc tocdepth=\"6\"?>\n"); modif=1 } {print}' > $@
 
 %.html: %.xml
 	xml2rfc --html $< -o $@
diff --git a/matroska_schema_section_header.md b/matroska_schema_section_header.md
index 749949f8..3e820f3a 100644
--- a/matroska_schema_section_header.md
+++ b/matroska_schema_section_header.md
@@ -1,9 +1,5 @@
 
-# Matroska Schema
-
-This specification includes an `EBML Schema` which defines the Elements and structure of Matroska as an EBML Document Type. The EBML Schema defines every valid Matroska element in a manner defined by the EBML specification.
-
-## Matroska Additions to Schema Element Attributes
+# Matroska Additions to Schema Element Attributes
 
 In addition to the EBML Schema definition provided by the EBML Specification, Matroska adds the following additional attributes:
 
@@ -11,8 +7,9 @@ In addition to the EBML Schema definition provided by the EBML Specification, Ma
 |:---------------|:---------|:-----------|
 | webm           | No       | A boolean to express if the Matroska Element is also supported within version 2 of the `webm` specification. Please consider the [webm specification](http://www.webmproject.org/docs/container/) as the authoritative on `webm`. |
 
-## Matroska Schema Element Definitions
+# Matroska Schema
+
+This specification includes an `EBML Schema` which defines the Elements and structure of Matroska as an EBML Document Type. The EBML Schema defines every valid Matroska element in a manner defined by the EBML specification.
 
 Here the definition of each Matroska Element is provided.
 
-% concatenate with Matroska EBML Schema converted to markdown %
diff --git a/transforms/ebml_schema2markdown4rfc.xsl b/transforms/ebml_schema2markdown4rfc.xsl
index f590a679..51b2aa52 100644
--- a/transforms/ebml_schema2markdown4rfc.xsl
+++ b/transforms/ebml_schema2markdown4rfc.xsl
@@ -9,10 +9,10 @@
   <xsl:template match="element">
     <xsl:choose>
       <xsl:when test="contains(@path,'\EBML\')">
-        <xsl:text>###</xsl:text>
+        <xsl:text>##</xsl:text>
       </xsl:when>
       <xsl:otherwise>
-        <xsl:value-of select="substring('############################',1,count(str:tokenize(@path,'\'))+1)"/>
+        <xsl:value-of select="substring('######',1,count(str:tokenize(@path,'\')))"/>
       </xsl:otherwise>
     </xsl:choose>
     <xsl:text> </xsl:text>