1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
using System.Text;
using Mono.Cecil;
namespace Mono.Linker
{
/// <summary>
/// Generates a signature for a member, in the format used for C# Documentation Comments:
/// https://github.com/dotnet/csharplang/blob/master/spec/documentation-comments.md#id-string-format
/// Adapted from Roslyn's DocumentationCommentIDVisitor:
/// https://github.com/dotnet/roslyn/blob/master/src/Compilers/CSharp/Portable/DocumentationComments/DocumentationCommentIDVisitor.cs
/// </summary>
public sealed partial class DocumentationSignatureGenerator
{
internal const string MethodPrefix = "M:";
internal const string FieldPrefix = "F:";
internal const string EventPrefix = "E:";
internal const string PropertyPrefix = "P:";
internal const string TypePrefix = "T:";
private DocumentationSignatureGenerator ()
{
}
public static void VisitMember (IMemberDefinition member, StringBuilder builder, ITryResolveMetadata resolver)
{
switch (member.MetadataToken.TokenType) {
case TokenType.TypeDef:
VisitTypeDefinition ((TypeDefinition) member, builder, resolver);
break;
case TokenType.Method:
VisitMethod ((MethodDefinition) member, builder, resolver);
break;
case TokenType.Property:
VisitProperty ((PropertyDefinition) member, builder, resolver);
break;
case TokenType.Field:
VisitField ((FieldDefinition) member, builder, resolver);
break;
case TokenType.Event:
VisitEvent ((EventDefinition) member, builder, resolver);
break;
default:
break;
}
}
private static void VisitMethod (MethodDefinition method, StringBuilder builder, ITryResolveMetadata resolver)
{
builder.Append (MethodPrefix);
PartVisitor.Instance.VisitMethodDefinition (method, builder, resolver);
}
private static void VisitField (FieldDefinition field, StringBuilder builder, ITryResolveMetadata resolver)
{
builder.Append (FieldPrefix);
PartVisitor.Instance.VisitField (field, builder, resolver);
}
private static void VisitEvent (EventDefinition evt, StringBuilder builder, ITryResolveMetadata resolver)
{
builder.Append (EventPrefix);
PartVisitor.Instance.VisitEvent (evt, builder, resolver);
}
private static void VisitProperty (PropertyDefinition property, StringBuilder builder, ITryResolveMetadata resolver)
{
builder.Append (PropertyPrefix);
PartVisitor.Instance.VisitProperty (property, builder, resolver);
}
private static void VisitTypeDefinition (TypeDefinition type, StringBuilder builder, ITryResolveMetadata resolver)
{
builder.Append (TypePrefix);
PartVisitor.Instance.VisitTypeReference (type, builder, resolver);
}
}
}
|