Improve section source feature to not require a title or content.

The title will be pulled from the source document.

doc/lib/BackRestDoc/Common/DocRender.pm

@@ -444,6 +444,15 @@ sub build
         {
             my $oSource = ${$self->{oManifest}->sourceGet($oNode->paramGet('source'))}{doc};
 
+            # Section should not already have title defined, it should come from the source doc
+            if ($oNode->nodeTest('title'))
+            {
+                confess &log(ERROR, "cannot specify title in section that sources another document");
+            }
+
+            # Set title from source doc's title
+            $oNode->nodeAdd('title')->textSet($oSource->paramGet('title'));
+
             foreach my $oSection ($oSource->nodeList('section'))
             {
                 push(@{${$oNode->{oDoc}}{children}}, $oSection->{oDoc});
@@ -451,6 +460,9 @@ sub build
 
             # Set path prefix to modify all section paths further down
             $strPathPrefix = $strPath;
+
+            # Remove source so it is not included again later
+            $oNode->paramSet('source', undef);
         }
     }
     # Build link

doc/xml/dtd/doc.dtd

@@ -113,7 +113,7 @@
 
 <!ELEMENT section (title?,
                    ((p|list|table|host-add|execute-list|backrest-config|postgres-config|cmd-description|
-                     option-description|code-block|block|section)+))>
+                     option-description|code-block|block|section)*))>
     <!ATTLIST section id CDATA #REQUIRED>
     <!ATTLIST section keyword CDATA "">
     <!ATTLIST section depend CDATA "">

doc/xml/release.xml

@@ -145,6 +145,10 @@
                         <p>Add coding standards document.</p>
                     </release-item>
 
+                    <release-item>
+                        <p>Improve section source feature to not require a title or content.  The title will be pulled from the source document.</p>
+                    </release-item>
+
                     <release-item>
                         <p>Deploy historical documentation to <path>prior</path> rather than the root directory.</p>
                     </release-item>