docs: (Sphinx) adapted script to create rst.inc instead of rst files

bareos · Mar 5, 2019 · 56e54b9 · 56e54b9
1 parent e762eda
commit 56e54b9
Showing 1 changed file with 4 additions and 2 deletions.
diff --git a/docs/manuals/scripts/generate-resoure-descriptions.py b/docs/manuals/scripts/generate-resoure-descriptions.py
@@ -355,7 +355,9 @@ def getDescription(self, data):
     def getConvertedResourceDirectives(self, daemon, resourcename):
         logger = logging.getLogger()
 
-        result='{}\n{}\n\n'.format(resourcename, len(resourcename) * '-')
+        result = ''
+        # only useful, when file is included by toctree.
+        #result='{}\n{}\n\n'.format(resourcename, len(resourcename) * '-')
         for directive in self.getResourceDirectives(daemon,resourcename):
             data=self.getResourceDirective(daemon, resourcename, directive)
 
@@ -453,7 +455,7 @@ def createSphinx(data):
         for resource in sphinx.getResources(daemon):
             logger.info( "daemon: " + daemon + ", resource: " + resource )
 
-            sphinx.writeResourceDirectives(daemon, resource, "autogenerated/" + daemon.lower()+ "-resource-"+resource.lower()+"-description.rst")
+            sphinx.writeResourceDirectives(daemon, resource, "autogenerated/" + daemon.lower()+ "-resource-"+resource.lower()+"-description.rst.inc")
 
 
     #if sphinx.getDatatypes():