mono/linux-packaging-mono
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Imported Upstream version 6.6.0.89

Browse Source 
Former-commit-id: b39a328747c2f3414dc52e009fb6f0aa80ca2492
This commit is contained in:
Xamarin Public Jenkins (auto-signing)
2019-09-24 08:53:40 +00:00
parent cf815e07e0
commit 95fdb59ea6
2556 changed files with 138145 additions and 47453 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
external/api-doc-tools/mdoc/Mono.Documentation/monodocs2slashdoc.cs vendored
View File

@ -15,6 +15,7 @@ public class MDocToMSXDocConverter : MDocCommand {
public override void Run (IEnumerable<string> args)
{
string file = null;
bool quiet = false;
var p = new OptionSet () {
{ "o|out=",
"The XML {FILE} to generate.\n" +
@ -22,6 +23,9 @@ public class MDocToMSXDocConverter : MDocCommand {
"based on the //AssemblyInfo/AssemblyName values within the documentation.\n" +
"Use '-' to write to standard output.",
v => file = v },
{ "q|quiet",
"Reduce logging to the console.",
v => quiet = v != null },
};
List<string> directories = Parse (p, args, "export-slashdoc",
"[OPTIONS]+ DIRECTORIES",
@ -29,10 +33,10 @@ public class MDocToMSXDocConverter : MDocCommand {
"Microsoft XML Documentation format files.");
if (directories == null)
return;
Run (file, directories);
Run (file, directories, quiet);
}
public static void Run (string file, IEnumerable<string> dirs)
public static void Run (string file, IEnumerable<string> dirs, bool quiet)
{
Dictionary<string, XmlElement> outputfiles = new Dictionary<string, XmlElement> ();
@ -64,14 +68,16 @@ public class MDocToMSXDocConverter : MDocCommand {
// Write out each of the assembly documents
foreach (string assemblyName in outputfiles.Keys) {
XmlElement members = (XmlElement)outputfiles[assemblyName];
Console.WriteLine(assemblyName + ".xml");
if (!quiet)
Console.WriteLine(assemblyName + ".xml");
using(StreamWriter sw = new StreamWriter(assemblyName + ".xml")) {
WriteXml(members.OwnerDocument.DocumentElement, sw);
}
}
// Write out a namespace summaries file.
Console.WriteLine("NamespaceSummaries.xml");
if (!quiet)
Console.WriteLine("NamespaceSummaries.xml");
using(StreamWriter writer = new StreamWriter("NamespaceSummaries.xml")) {
WriteXml(nsSummaries.DocumentElement, writer);
}
@ -166,13 +172,23 @@ public class MDocToMSXDocConverter : MDocCommand {
StringBuilder args = new StringBuilder ();
args.Append ("(");
args.Append (XmlDocUtils.ToTypeName (parameters [0].Attributes ["Type"].Value, member));
for (int i = 1; i < parameters.Count; ++i) {
AppendRefSymbol(args, parameters[0]);
for (int i = 1; i < parameters.Count; ++i) {
args.Append (",");
args.Append (XmlDocUtils.ToTypeName (parameters [i].Attributes ["Type"].Value, member));
AppendRefSymbol(args, parameters[i]);
}
args.Append (")");
return args.ToString ();
}
private static void AppendRefSymbol(StringBuilder args, XmlNode parameter)
{
if (parameter.Attributes["RefType"]?.Value == "out" || parameter.Attributes["RefType"]?.Value == "ref")
args.Append("@");
}
private static void AddNamespaceSummary(XmlDocument nsSummaries, string basepath, string currentNs) {
foreach (var filename in new [] {