Преглед на файлове

Add more detailed comments for declaration properties

Jon Skeet преди 7 години
родител
ревизия
6e39eaad3c
променени са 1 файла, в които са добавени 11 реда и са изтрити 5 реда
  1. 11 5
      csharp/src/Google.Protobuf/Reflection/DescriptorDeclaration.cs

+ 11 - 5
csharp/src/Google.Protobuf/Reflection/DescriptorDeclaration.cs

@@ -64,24 +64,30 @@ namespace Google.Protobuf.Reflection
         /// </summary>
         /// </summary>
         public int EndLine { get; }
         public int EndLine { get; }
         /// <summary>
         /// <summary>
-        /// The end column of the declaration within the source file. This value is 1-based.
+        /// The end column of the declaration within the source file. This value is 1-based, and
+        /// exclusive. (The final character of the declaration is on the column before this value.)
         /// </summary>
         /// </summary>
         public int EndColumn { get; }
         public int EndColumn { get; }
 
 
         /// <summary>
         /// <summary>
-        /// Comments appearing before the declaration. Never null, but may be empty.
+        /// Comments appearing before the declaration. Never null, but may be empty. Multi-line comments
+        /// are represented as a newline-separated string. Leading whitespace and the comment marker ("//")
+        /// are removed from each line.
         /// </summary>
         /// </summary>
         public string LeadingComments { get; }
         public string LeadingComments { get; }
 
 
         /// <summary>
         /// <summary>
-        /// Comments appearing after the declaration. Never null, but may be empty.
+        /// Comments appearing after the declaration. Never null, but may be empty. Multi-line comments
+        /// are represented as a newline-separated string. Leading whitespace and the comment marker ("//")
+        /// are removed from each line.
         /// </summary>
         /// </summary>
         public string TrailingComments { get; }
         public string TrailingComments { get; }
 
 
         /// <summary>
         /// <summary>
         /// Comments appearing before the declaration, but separated from it by blank
         /// Comments appearing before the declaration, but separated from it by blank
-        /// lines. Each string represents a paragraph of comments. The list is never null,
-        /// but may be empty. Likewise each element is never null, but may be empty.
+        /// lines. Each string represents a newline-separated paragraph of comments.
+        /// Leading whitespace and the comment marker ("//") are removed from each line.
+        /// The list is never null, but may be empty. Likewise each element is never null, but may be empty.
         /// </summary>
         /// </summary>
         public IReadOnlyList<string> LeadingDetachedComments { get; }
         public IReadOnlyList<string> LeadingDetachedComments { get; }