Imported Upstream version 5.4.0.167

Former-commit-id: 5624ac747d633e885131e8349322922b6a59baaa

external/api-doc-tools/monodoc/Monodoc/generators/RawGenerator.cs

@@ -0,0 +1,41 @@
+using System;
+using System.IO;
+using System.Text;
+using System.Linq;
+using System.Collections.Generic;
+
+using Monodoc;
+
+namespace Monodoc.Generators
+{
+	/// <summary>
+	/// This generators returns the raw content of the HelpSource without any transformation
+	/// </summary>
+	public class RawGenerator : IDocGenerator<string>
+	{
+		public string Generate (HelpSource hs, string id, Dictionary<string, string> context)
+		{
+			if (hs == null || string.IsNullOrEmpty (id))
+				return null;
+
+			IEnumerable<string> parts;
+			if (hs.IsMultiPart (id, out parts))
+				return GenerateMultiPart (hs, parts, id, context);
+
+			if (hs.IsRawContent (id))
+				return hs.GetText (id) ?? string.Empty;
+
+			var result = hs.IsGeneratedContent (id) ? hs.GetCachedText (id) : new StreamReader (hs.GetCachedHelpStream (id)).ReadToEnd ();
+
+			return result;
+		}
+
+		string GenerateMultiPart (HelpSource hs, IEnumerable<string> ids, string originalId, Dictionary<string, string> context)
+		{
+			var sb = new StringBuilder ();
+			foreach (var id in ids)
+				sb.AppendLine (Generate (hs, id, context));
+			return sb.ToString ();
+		}
+	}
+}