build: Add support for specifying documents to build

Use as a comma separated list:

  --doc-list=eng,c-user

common/waf.py

@@ -238,6 +238,8 @@ def run_sphinx(bld):
     ctx.end_msg('found')
 
 def cmd_configure(ctx):
+    ctx.env.DOC_LIST = ctx.options.doc_list[0].split(
+        ",") if ctx.options.doc_list else []
     ctx.env.PYTHON = ["python3"]
     ctx.check_python_version((3,9))
     ctx.load("python")
@@ -272,6 +274,7 @@ def cmd_configure(ctx):
         ctx.env.append_value('SPHINX_OPTIONS', opt)
         ctx.end_msg(msg)
 
+
         #
         # Check extensions.
         #
@@ -291,6 +294,7 @@ def cmd_configure(ctx):
         else:
             pass
 
+
     #
     # Optional builds.
     #
@@ -569,6 +573,11 @@ def cmd_options(ctx):
                    action = 'store_true',
                    default = False,
                    help = "Build DITAA images using PlantUML from source, need ditaa and puml")
+    ctx.add_option('--doc-list',
+                   action = 'store',
+                   default = "",
+                   nargs="+",
+                   help = "Comma separated list of docs to build.")
 
 def cmd_options_path(ctx):
     cmd_options(ctx)

wscript

@@ -97,6 +97,13 @@ def build(ctx):
     ctx.recurse('images')
     ctx.add_group('images')
 
+    if ctx.env.DOC_LIST:
+        global building
+        for doc in ctx.env.DOC_LIST:
+            if doc not in building:
+                ctx.fatal("'{}' not in doc list".format(doc))
+        building = ctx.env.DOC_LIST
+
     for b in building:
         ctx.recurse(b)