Added support for XML doc in C#, F#, and VB.net (#2340)

components.json

@@ -1145,6 +1145,12 @@
 			},
 			"owner": "freakmaxi"
 		},
+		"xml-doc": {
+			"title": "XML doc (.net)",
+			"require": "markup",
+			"modify": ["csharp", "fsharp", "vbnet"],
+			"owner": "RunDevelopment"
+		},
 		"xojo": {
 			"title": "Xojo (REALbasic)",
 			"owner": "Golmote"

components/prism-xml-doc.js

@@ -0,0 +1,40 @@
+(function (Prism) {
+
+	/**
+	 * If the given language is present, it will insert the given doc comment grammar token into it.
+	 *
+	 * @param {string} lang
+	 * @param {any} docComment
+	 */
+	function insertDocComment(lang, docComment) {
+		if (Prism.languages[lang]) {
+			Prism.languages.insertBefore(lang, 'comment', {
+				'doc-comment': docComment
+			});
+		}
+	}
+
+	var tag = Prism.languages.markup.tag;
+
+	var slashDocComment = {
+		pattern: /\/\/\/.*/,
+		greedy: true,
+		alias: 'comment',
+		inside: {
+			'tag': tag
+		}
+	};
+	var tickDocComment = {
+		pattern: /'''.*/,
+		greedy: true,
+		alias: 'comment',
+		inside: {
+			'tag': tag
+		}
+	};
+
+	insertDocComment('csharp', slashDocComment);
+	insertDocComment('fsharp', slashDocComment);
+	insertDocComment('vbnet', tickDocComment);
+
+}(Prism));

examples/prism-xml-doc.html

@@ -0,0 +1,14 @@
+<h2>C#</h2>
+<pre><code class="language-csharp">/// &lt;summary>
+/// Summary documentation goes here.
+/// &lt;/summary></code></pre>
+
+<h2>F#</h2>
+<pre><code class="language-fsharp">/// &lt;summary>
+/// Summary documentation goes here.
+/// &lt;/summary></code></pre>
+
+<h2>VB.net</h2>
+<pre><code class="language-vbnet">''' &lt;summary>
+''' Summary documentation goes here.
+''' &lt;/summary></code></pre>

plugins/autoloader/prism-autoloader.js

@@ -141,6 +141,7 @@
 		"velocity": "markup",
 		"wiki": "markup",
 		"xeora": "markup",
+		"xml-doc": "markup",
 		"xquery": "markup"
 	}/*]*/;
 

plugins/show-language/prism-show-language.js

@@ -179,6 +179,7 @@
 		"wasm": "WebAssembly",
 		"wiki": "Wiki markup",
 		"xeoracube": "XeoraCube",
+		"xml-doc": "XML doc (.net)",
 		"xojo": "Xojo (REALbasic)",
 		"xquery": "XQuery",
 		"yaml": "YAML",

tests/languages/csharp!+xml-doc/inclusion.test

@@ -0,0 +1,65 @@
+/// <summary>
+/// Class level summary documentation goes here.
+/// </summary>
+/// <remarks>
+/// Longer comments can be associated with a type or member through
+/// the remarks tag.
+/// </remarks>
+
+----------------------------------------------------
+
+[
+	["doc-comment", [
+		"/// ",
+		["tag", [
+			["tag", [
+				["punctuation", "<"],
+				"summary"
+			]],
+			["punctuation", ">"]
+		]]
+	]],
+	["doc-comment", [
+		"/// Class level summary documentation goes here."
+	]],
+	["doc-comment", [
+		"/// ",
+		["tag", [
+			["tag", [
+				["punctuation", "</"],
+				"summary"
+			]],
+			["punctuation", ">"]
+		]]
+	]],
+	["doc-comment", [
+		"/// ",
+		["tag", [
+			["tag", [
+				["punctuation", "<"],
+				"remarks"
+			]],
+			["punctuation", ">"]
+		]]
+	]],
+	["doc-comment", [
+		"/// Longer comments can be associated with a type or member through"
+	]],
+	["doc-comment", [
+		"/// the remarks tag."
+	]],
+	["doc-comment", [
+		"/// ",
+		["tag", [
+			["tag", [
+				["punctuation", "</"],
+				"remarks"
+			]],
+			["punctuation", ">"]
+		]]
+	]]
+]
+
+----------------------------------------------------
+
+Checks for XML documentation comments.