Documentation rework to unify the docs together rather than having them

on a per port basis.

Also enables generating docs from inline RST in C code. Simply omits all
lines except those that start with //|. Indentation after "//| " will be
preserved.

1 files changed, 17 insertions, 0 deletions

diff --git a/c2rst.py b/c2rst.py
new file mode 100644
index 000000000..6b0fe646a
--- /dev/null
+++ b/c2rst.py
@@ -0,0 +1,17 @@
+import sphinx.parsers
+import docutils.parsers.rst as rst
+
+class CStrip(sphinx.parsers.Parser):
+  def __init__(self):
+    self.rst_parser = rst.Parser()
+
+  def parse(self, inputstring, document):
+    stripped = []
+    for line in inputstring.split("\n"):
+      line = line.strip()
+      if line == "//|":
+        stripped.append("")
+      elif line.startswith("//| "):
+        stripped.append(line[len("//| "):])
+    stripped = "\r\n".join(stripped)
+    self.rst_parser.parse(stripped, document)