Skip to content

Commit 3d60ed6

Browse files
committed
optimize documentation for assembly class
1 parent fc4916f commit 3d60ed6

1 file changed

Lines changed: 49 additions & 33 deletions

File tree

Mono.Debugging/Mono.Debugging.Client/Assembly.cs

Lines changed: 49 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -26,41 +26,11 @@
2626
using System;
2727
namespace Mono.Debugging.Client
2828
{
29+
/// <summary>
30+
/// Represents the assembly loaded during the debugging session.
31+
/// </summary>
2932
public class Assembly
3033
{
31-
/// <summary>
32-
/// Represent the assembly loaded during the debugging session. This dataclass will be used in the modules pad view for display.
33-
/// </summary>
34-
/// <param name="name"></param>
35-
/// String represent the name of the assembly.
36-
/// <param name="path"></param>
37-
/// String represent the local path of the assembly is loaded from.
38-
/// <param name="optimized"></param>
39-
/// Boolean shows if the assembly has been optimized, true if the assembly is optimized.
40-
/// <param name="userCode"></param>
41-
/// Boolean show if the assembly is considered 'user code' by a debugger that supports 'Just My Code'.True if it's considered.
42-
/// <param name="symbolStatus"></param>
43-
/// String represent the Description on if symbols were found for the assembly (ex: 'Symbols Loaded', 'Symbols not found', etc.
44-
/// <param name="symbolFile"></param>
45-
/// String represent the Logical full path to the symbol file. The exact definition is implementation defined.
46-
/// <param name="order"></param>
47-
/// Integer indicating the order in which the assembly was loaded.
48-
/// <param name="version"></param>
49-
/// String represent the version of assembly.
50-
/// <param name="timestamp"></param>
51-
/// String represent the time when the assembly was built in the units of UNIX timestamp formatted as a 64-bit unsigned decimal number in a string.
52-
/// <param name="address"></param>
53-
/// String resent the Address where the assembly was loaded as a 64-bit unsigned decimal number.
54-
/// <param name="process"></param>
55-
/// String represent the process name and process ID the assembly is loaded.
56-
/// <param name="appdomain"></param>
57-
/// String indicates the name of the AppDomain where the assembly is loaded.
58-
/// <param name="processId"></param>
59-
/// Long represent the process ID the assembly is loaded.
60-
/// <param name="hasSymbol"></param
61-
/// Bool value indicate if the assembly has symbol file. Mainly use for mono project.
62-
/// <param name="isDynamic"></param>
63-
/// Bool value indicate if the assembly is a dynamic. Mainly use for mono project.
6434
public Assembly (string name, string path, bool optimized, bool userCode, string symbolStatus, string symbolFile, int? order, string version, string timestamp, string address, string process, string appdomain, long? processId, bool hasSymbol = false, bool isDynamic = false)
6535
{
6636
Name = name;
@@ -79,39 +49,85 @@ public Assembly (string name, string path, bool optimized, bool userCode, string
7949
IsDynamic = isDynamic;
8050
HasSymbols = hasSymbol;
8151
}
52+
8253
public Assembly (string path)
8354
{
8455
Path = path;
8556
}
8657

58+
/// <summary>
59+
/// Represents the name of the assembly.
60+
/// </summary>
8761
public string Name { get; private set; }
8862

63+
/// <summary>
64+
/// Represents the local path of the assembly is loaded from.
65+
/// </summary>
8966
public string Path { get; private set; }
9067

68+
/// <summary>
69+
/// Shows if the assembly has been optimized, true if the assembly is optimized.
70+
/// </summary>
9171
public bool Optimized { get; private set; }
9272

73+
/// <summary>
74+
/// Shows if the assembly is considered 'user code' by a debugger that supports 'Just My Code'.True if it's considered.
75+
/// </summary>
9376
public bool UserCode { get; private set; }
9477

78+
/// <summary>
79+
/// Represents the Description on if symbols were found for the assembly (ex: 'Symbols Loaded', 'Symbols not found', etc.
80+
/// </summary>
9581
public string SymbolStatus { get; private set; }
9682

83+
/// <summary>
84+
/// Represents the Logical full path to the symbol file. The exact definition is implementation defined.
85+
/// </summary>
9786
public string SymbolFile { get; private set; }
9887

88+
/// <summary>
89+
/// Represents the order in which the assembly was loaded.
90+
/// </summary>
9991
public int Order { get; private set; } = -1;
10092

93+
/// <summary>
94+
/// Represents the version of assembly.
95+
/// </summary>
10196
public string Version { get; private set; }
10297

98+
/// <summary>
99+
/// Represents the time when the assembly was built in the units of UNIX timestamp formatted as a 64-bit unsigned decimal number in a string.
100+
/// </summary>
103101
public string TimeStamp { get; private set; }
104102

103+
/// <summary>
104+
/// Represents the Address where the assembly was loaded as a 64-bit unsigned decimal number.
105+
/// </summary>
105106
public string Address { get; private set; }
106107

108+
/// <summary>
109+
/// Represent the process name and process ID the assembly is loaded.
110+
/// </summary>
107111
public string Process { get; private set; }
108112

113+
/// <summary>
114+
/// Represent the name of the AppDomain where the assembly is loaded.
115+
/// </summary>
109116
public string AppDomain { get; private set; }
110117

118+
/// <summary>
119+
/// Represent the process ID the assembly is loaded.
120+
/// </summary>
111121
public long? ProcessId { get; private set; } = -1;
112122

123+
/// <summary>
124+
/// Indicates if the assembly has symbol file. Mainly use for mono project.
125+
/// </summary>
113126
public bool HasSymbols { get; private set; }
114127

128+
/// <summary>
129+
/// Indicate if the assembly is a dynamic. Mainly use for mono project.
130+
/// </summary>
115131
public bool IsDynamic { get; private set; }
116132
}
117133
}

0 commit comments

Comments
 (0)