Add DdocComment.renderParameters.

Adds the possibility for more fine-grained  rendering of the "Params" section in cases where the name/description table layout is undesirable.

Author: s-ludwig

source/ddox/ddoc.d

@@ -232,6 +232,15 @@ class DdocComment {
 		renderSectionsR(dst, context, display_section, hlevel);
 		return dst.data;
 	}
+
+	void renderParameters(DdocContext context,
+		void delegate(string, string) @safe on_parameter)
+	{
+		auto idx = m_sections.countUntil!(s => s.name == "Params");
+		if (idx < 0) return;
+
+		.renderParameters(context, m_sections[idx], on_parameter);
+	}
 }
 
 enum DdocRenderOptions {
@@ -431,6 +440,39 @@ private void parseSection(R)(ref R dst, string sect, string[] lines, DdocContext
 	}
 }
 
+private void renderParameters(DdocContext context, Section parms_section,
+	void delegate(string, string) @safe del)
+{
+	string paramname;
+	string desc;
+
+	foreach (string ln; parms_section.lines) {
+		// check if the line starts a parameter documentation
+		string name;
+		auto eidx = ln.indexOf("=");
+		if (eidx > 0) name = ln[0 .. eidx].strip();
+		if (!isIdent(name)) name = null;
+
+		// if it does, start a new row
+		if (name.length) {
+			if (paramname !is null) {
+				auto dst = appender!string;
+				renderTextLine(dst, desc, context);
+				del(paramname, dst.data);
+			}
+
+			desc = ln[eidx+1 .. $];
+			paramname = name;
+		} else if (paramname !is null) desc ~= "\n" ~ ln;
+	}
+
+	if (paramname !is null) {
+		auto dst = appender!string;
+		renderTextLine(dst, desc, context);
+		del(paramname, dst.data);
+	}
+}
+
 private string highlightAndCrossLink(string line, DdocContext context)
 {
 	auto dst = appender!string;