Add initial version of the Ddoc wrapper

Author: wilzbach

ddoc.d

@@ -0,0 +1,60 @@
+#!/usr/bin/env rdmd
+/**
+A wrapper around DDoc to allow custom extensions
+
+Copyright: D Language Foundation 2018
+
+License:   $(WEB boost.org/LICENSE_1_0.txt, Boost License 1.0).
+
+Example usage:
+
+---
+./ddoc --compiler=<path-to-dmd> --output=out.html myfile.dd
+---
+
+Author: Sebastian Wilzbach
+*/
+import std.stdio;
+
+struct Config
+{
+    string dmdBinPath = "dmd";
+    string outputFile;
+}
+Config config;
+
+int main(string[] args)
+{
+    import std.getopt;
+    auto helpInformation = getopt(
+        args,
+        "compiler", "Compiler to use", &config.dmdBinPath,
+        "o|output", "Output file", &config.outputFile,
+    );
+
+    assert(config.outputFile, "An output file is required.");
+    assert(args.length > 1, "An input file is required.");
+
+    if (helpInformation.helpWanted)
+    {
+`DDoc wrapper
+./ddoc <file>...
+`.defaultGetoptPrinter(helpInformation.options);
+        return 1;
+    }
+
+    import std.file : readText;
+    auto text = args[$ - 1].readText;
+    return compile(text, args[1 .. $ - 1]);
+}
+
+auto compile(R)(R buffer, string[] arguments)
+{
+    import std.process : pipeProcess, Redirect, wait;
+    auto args = [config.dmdBinPath, "-c", "-Df"~config.outputFile, "-o-"] ~ arguments;
+    args ~= "-";
+    auto pipes = pipeProcess(args, Redirect.stdin);
+    pipes.stdin.write(buffer);
+    pipes.stdin.close;
+    return wait(pipes.pid);
+}

posix.mak

@@ -277,6 +277,12 @@ DDOC_VARS_PRERELEASE_VERBATIM=$(DDOC_VARS_PRERELEASE) \
 	DOC_OUTPUT_DIR="$W/phobos-prerelease-verbatim" \
 	STDDOC="$(PWD)/verbatim.ddoc"
 
+################################################################################
+# Ddoc binaries
+################################################################################
+
+DDOC_BIN:=$G/ddoc
+
 ################################################################################
 # Resources
 ################################################################################
@@ -460,8 +466,8 @@ $W/changelog/pending.html : changelog/pending.dd $(CHANGELOG_PENDING_DDOC) $(DMD
 $W/changelog/%.html : changelog/%.dd $(CHANGELOG_DDOC) $(DMD)
 	$(DMD) -conf= -c -o- -Df$@ $(CHANGELOG_DDOC) $<
 
-$W/spec/%.html : spec/%.dd $(SPEC_DDOC) $(DMD)
-	$(DMD) -c -o- -Df$@ $(SPEC_DDOC) $<
+$W/spec/%.html : spec/%.dd $(SPEC_DDOC) $(DMD) $(DDOC_BIN)
+	$(DDOC_BIN) --compiler=$(DMD) -o$@ $(SPEC_DDOC) $<
 
 $W/404.html : 404.dd $(DDOC) $(DMD)
 	$(DMD) -conf= -c -o- -Df$@ $(DDOC) errorpage.ddoc $<
@@ -947,4 +953,15 @@ $G/contributors_list.ddoc:  | $(STABLE_RDMD) $(TOOLS_DIR) $(INSTALLER_DIR)
 	echo "D_CONTRIBUTORS=" >> $@
 	cat $G/contributors_list.tmp >> $@
 
+################################################################################
+# Custom DDoc wrapper
+# ------------------
+#
+# This allows extending Ddoc files dynamically on-the-fly.
+# It is currently only used for the specification pages
+################################################################################
+
+$(DDOC_BIN): ddoc.d | $(STABLE_DMD)
+	$(STABLE_DMD) -of$@ $<
+
 .DELETE_ON_ERROR: # GNU Make directive (delete output files on error)