From 937d5a53bbd1b218a90bf67f095c49f05cbeee24 Mon Sep 17 00:00:00 2001 From: stakx Date: Mon, 19 Dec 2016 09:27:59 +0100 Subject: [PATCH] XML comments: consistent formatting of C# keywords --- Src/Newtonsoft.Json/FloatFormatHandling.cs | 2 +- Src/Newtonsoft.Json/JsonContainerAttribute.cs | 8 +++--- Src/Newtonsoft.Json/JsonConvert.cs | 26 +++++++++---------- Src/Newtonsoft.Json/JsonConverterAttribute.cs | 4 +-- Src/Newtonsoft.Json/JsonException.cs | 6 ++--- Src/Newtonsoft.Json/JsonPropertyAttribute.cs | 8 +++--- Src/Newtonsoft.Json/JsonReader.cs | 2 +- Src/Newtonsoft.Json/JsonReaderException.cs | 6 ++--- .../JsonSerializationException.cs | 6 ++--- Src/Newtonsoft.Json/JsonTextReader.cs | 6 ++--- Src/Newtonsoft.Json/JsonValidatingReader.cs | 2 +- Src/Newtonsoft.Json/JsonWriter.cs | 3 ++- Src/Newtonsoft.Json/JsonWriterException.cs | 6 ++--- Src/Newtonsoft.Json/Linq/JArray.cs | 10 +++---- Src/Newtonsoft.Json/Linq/JConstructor.cs | 2 +- Src/Newtonsoft.Json/Linq/JObject.cs | 6 ++--- Src/Newtonsoft.Json/Linq/JProperty.cs | 2 +- Src/Newtonsoft.Json/Linq/JToken.cs | 8 +++--- .../Linq/JTokenEqualityComparer.cs | 2 +- Src/Newtonsoft.Json/MemberSerialization.cs | 2 +- .../Schema/JsonSchemaException.cs | 6 ++--- .../Serialization/DefaultContractResolver.cs | 2 +- .../Serialization/IAttributeProvider.cs | 4 +-- .../Serialization/JsonTypeReflector.cs | 2 +- .../ReflectionAttributeProvider.cs | 4 +-- .../Utilities/CollectionUtils.cs | 4 +-- Src/Newtonsoft.Json/Utilities/MethodBinder.cs | 4 +-- Src/Newtonsoft.Json/Utilities/StringUtils.cs | 2 +- 28 files changed, 73 insertions(+), 72 deletions(-) diff --git a/Src/Newtonsoft.Json/FloatFormatHandling.cs b/Src/Newtonsoft.Json/FloatFormatHandling.cs index 51c4603e..6a9ba6af 100644 --- a/Src/Newtonsoft.Json/FloatFormatHandling.cs +++ b/Src/Newtonsoft.Json/FloatFormatHandling.cs @@ -43,7 +43,7 @@ namespace Newtonsoft.Json Symbol = 1, /// - /// Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a property. + /// Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a property. /// DefaultValue = 2 } diff --git a/Src/Newtonsoft.Json/JsonContainerAttribute.cs b/Src/Newtonsoft.Json/JsonContainerAttribute.cs index 7977d8e3..266d2b47 100644 --- a/Src/Newtonsoft.Json/JsonContainerAttribute.cs +++ b/Src/Newtonsoft.Json/JsonContainerAttribute.cs @@ -60,8 +60,8 @@ namespace Newtonsoft.Json /// /// The parameter list to use when constructing the described by . - /// If null, the default constructor is used. - /// When non-null, there must be a constructor defined in the that exactly matches the number, + /// If null, the default constructor is used. + /// When non-null, there must be a constructor defined in the that exactly matches the number, /// order, and type of these parameters. /// /// @@ -87,8 +87,8 @@ namespace Newtonsoft.Json /// /// The parameter list to use when constructing the described by . - /// If null, the default constructor is used. - /// When non-null, there must be a constructor defined in the that exactly matches the number, + /// If null, the default constructor is used. + /// When non-null, there must be a constructor defined in the that exactly matches the number, /// order, and type of these parameters. /// /// diff --git a/Src/Newtonsoft.Json/JsonConvert.cs b/Src/Newtonsoft.Json/JsonConvert.cs index 965a1cc2..ccff0aff 100644 --- a/Src/Newtonsoft.Json/JsonConvert.cs +++ b/Src/Newtonsoft.Json/JsonConvert.cs @@ -579,7 +579,7 @@ namespace Newtonsoft.Json /// /// The object to serialize. /// The used to serialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// A JSON string representation of the object. /// @@ -593,7 +593,7 @@ namespace Newtonsoft.Json /// /// The object to serialize. /// The used to serialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// The type of the value being serialized. /// This parameter is used when is Auto to write out the type name if the type of the value does not match. @@ -615,7 +615,7 @@ namespace Newtonsoft.Json /// The object to serialize. /// Indicates how the output should be formatted. /// The used to serialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// A JSON string representation of the object. /// @@ -630,7 +630,7 @@ namespace Newtonsoft.Json /// The object to serialize. /// Indicates how the output should be formatted. /// The used to serialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// The type of the value being serialized. /// This parameter is used when is Auto to write out the type name if the type of the value does not match. @@ -698,7 +698,7 @@ namespace Newtonsoft.Json /// The object to serialize. /// Indicates how the output should be formatted. /// The used to serialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. /// @@ -727,7 +727,7 @@ namespace Newtonsoft.Json /// The JSON to deserialize. /// /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// The deserialized object from the JSON string. public static object DeserializeObject(string value, JsonSerializerSettings settings) @@ -785,7 +785,7 @@ namespace Newtonsoft.Json /// The anonymous type object. /// /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// The deserialized anonymous type from the JSON string. public static T DeserializeAnonymousType(string value, T anonymousTypeObject, JsonSerializerSettings settings) @@ -812,7 +812,7 @@ namespace Newtonsoft.Json /// The object to deserialize. /// /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// The deserialized object from the JSON string. public static T DeserializeObject(string value, JsonSerializerSettings settings) @@ -843,7 +843,7 @@ namespace Newtonsoft.Json /// The type of the object to deserialize to. /// /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// The deserialized object from the JSON string. public static object DeserializeObject(string value, Type type, JsonSerializerSettings settings) @@ -888,7 +888,7 @@ namespace Newtonsoft.Json /// The JSON to deserialize. /// /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// /// A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -921,7 +921,7 @@ namespace Newtonsoft.Json /// The type of the object to deserialize to. /// /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// /// A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -952,7 +952,7 @@ namespace Newtonsoft.Json /// The target object to populate values onto. /// /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// public static void PopulateObject(string value, object target, JsonSerializerSettings settings) { @@ -977,7 +977,7 @@ namespace Newtonsoft.Json /// The target object to populate values onto. /// /// The used to deserialize the object. - /// If this is null, default serialization settings will be used. + /// If this is null, default serialization settings will be used. /// /// /// A task that represents the asynchronous population operation. diff --git a/Src/Newtonsoft.Json/JsonConverterAttribute.cs b/Src/Newtonsoft.Json/JsonConverterAttribute.cs index 6f112b4c..ef9d2c11 100644 --- a/Src/Newtonsoft.Json/JsonConverterAttribute.cs +++ b/Src/Newtonsoft.Json/JsonConverterAttribute.cs @@ -48,7 +48,7 @@ namespace Newtonsoft.Json /// /// The parameter list to use when constructing the described by . - /// If null, the default constructor is used. + /// If null, the default constructor is used. /// public object[] ConverterParameters { get; private set; } @@ -70,7 +70,7 @@ namespace Newtonsoft.Json /// Initializes a new instance of the class. /// /// Type of the . - /// Parameter list to use when constructing the . Can be null. + /// Parameter list to use when constructing the . Can be null. public JsonConverterAttribute(Type converterType, params object[] converterParameters) : this(converterType) { diff --git a/Src/Newtonsoft.Json/JsonException.cs b/Src/Newtonsoft.Json/JsonException.cs index 306916ac..e1460324 100644 --- a/Src/Newtonsoft.Json/JsonException.cs +++ b/Src/Newtonsoft.Json/JsonException.cs @@ -62,7 +62,7 @@ namespace Newtonsoft.Json /// with a specified error message and a reference to the inner exception that is the cause of this exception. /// /// The error message that explains the reason for the exception. - /// The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + /// The exception that is the cause of the current exception, or null if no inner exception is specified. public JsonException(string message, Exception innerException) : base(message, innerException) { @@ -74,8 +74,8 @@ namespace Newtonsoft.Json /// /// The that holds the serialized object data about the exception being thrown. /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). + /// The parameter is null. + /// The class name is null or is zero (0). public JsonException(SerializationInfo info, StreamingContext context) : base(info, context) { diff --git a/Src/Newtonsoft.Json/JsonPropertyAttribute.cs b/Src/Newtonsoft.Json/JsonPropertyAttribute.cs index a3de89ae..46e582fd 100644 --- a/Src/Newtonsoft.Json/JsonPropertyAttribute.cs +++ b/Src/Newtonsoft.Json/JsonPropertyAttribute.cs @@ -56,8 +56,8 @@ namespace Newtonsoft.Json /// /// The parameter list to use when constructing the described by . - /// If null, the default constructor is used. - /// When non-null, there must be a constructor defined in the that exactly matches the number, + /// If null, the default constructor is used. + /// When non-null, there must be a constructor defined in the that exactly matches the number, /// order, and type of these parameters. /// /// @@ -75,8 +75,8 @@ namespace Newtonsoft.Json /// /// The parameter list to use when constructing the described by NamingStrategyType. - /// If null, the default constructor is used. - /// When non-null, there must be a constructor defined in the that exactly matches the number, + /// If null, the default constructor is used. + /// When non-null, there must be a constructor defined in the that exactly matches the number, /// order, and type of these parameters. /// /// diff --git a/Src/Newtonsoft.Json/JsonReader.cs b/Src/Newtonsoft.Json/JsonReader.cs index 0ac78138..a1e52dd9 100644 --- a/Src/Newtonsoft.Json/JsonReader.cs +++ b/Src/Newtonsoft.Json/JsonReader.cs @@ -509,7 +509,7 @@ namespace Newtonsoft.Json /// /// Reads the next JSON token from the stream as a []. /// - /// A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + /// A [] or null if the next JSON token is null. This method will return null at the end of an array. public virtual byte[] ReadAsBytes() { JsonToken t = GetContentToken(); diff --git a/Src/Newtonsoft.Json/JsonReaderException.cs b/Src/Newtonsoft.Json/JsonReaderException.cs index e74b29dc..6348df94 100644 --- a/Src/Newtonsoft.Json/JsonReaderException.cs +++ b/Src/Newtonsoft.Json/JsonReaderException.cs @@ -78,7 +78,7 @@ namespace Newtonsoft.Json /// with a specified error message and a reference to the inner exception that is the cause of this exception. /// /// The error message that explains the reason for the exception. - /// The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + /// The exception that is the cause of the current exception, or null if no inner exception is specified. public JsonReaderException(string message, Exception innerException) : base(message, innerException) { @@ -90,8 +90,8 @@ namespace Newtonsoft.Json /// /// The that holds the serialized object data about the exception being thrown. /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). + /// The parameter is null. + /// The class name is null or is zero (0). public JsonReaderException(SerializationInfo info, StreamingContext context) : base(info, context) { diff --git a/Src/Newtonsoft.Json/JsonSerializationException.cs b/Src/Newtonsoft.Json/JsonSerializationException.cs index 5ba3ede4..13baa0bd 100644 --- a/Src/Newtonsoft.Json/JsonSerializationException.cs +++ b/Src/Newtonsoft.Json/JsonSerializationException.cs @@ -60,7 +60,7 @@ namespace Newtonsoft.Json /// with a specified error message and a reference to the inner exception that is the cause of this exception. /// /// The error message that explains the reason for the exception. - /// The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + /// The exception that is the cause of the current exception, or null if no inner exception is specified. public JsonSerializationException(string message, Exception innerException) : base(message, innerException) { @@ -72,8 +72,8 @@ namespace Newtonsoft.Json /// /// The that holds the serialized object data about the exception being thrown. /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). + /// The parameter is null. + /// The class name is null or is zero (0). public JsonSerializationException(SerializationInfo info, StreamingContext context) : base(info, context) { diff --git a/Src/Newtonsoft.Json/JsonTextReader.cs b/Src/Newtonsoft.Json/JsonTextReader.cs index ff1f8a95..8a05f306 100644 --- a/Src/Newtonsoft.Json/JsonTextReader.cs +++ b/Src/Newtonsoft.Json/JsonTextReader.cs @@ -445,7 +445,7 @@ namespace Newtonsoft.Json /// /// Reads the next JSON token from the stream as a []. /// - /// A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + /// A [] or null if the next JSON token is null. This method will return null at the end of an array. public override byte[] ReadAsBytes() { EnsureBuffer(); @@ -2440,7 +2440,7 @@ namespace Newtonsoft.Json /// Gets the current line number. /// /// - /// The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + /// The current line number or 0 if no line information is available (for example, HasLineInfo returns false). /// public int LineNumber { @@ -2459,7 +2459,7 @@ namespace Newtonsoft.Json /// Gets the current line position. /// /// - /// The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + /// The current line position or 0 if no line information is available (for example, HasLineInfo returns false). /// public int LinePosition { diff --git a/Src/Newtonsoft.Json/JsonValidatingReader.cs b/Src/Newtonsoft.Json/JsonValidatingReader.cs index ecb1b3d4..26c0db7e 100644 --- a/Src/Newtonsoft.Json/JsonValidatingReader.cs +++ b/Src/Newtonsoft.Json/JsonValidatingReader.cs @@ -407,7 +407,7 @@ namespace Newtonsoft.Json /// Reads the next JSON token from the stream as a []. /// /// - /// A [] or a null reference if the next JSON token is null. + /// A [] or null if the next JSON token is null. /// public override byte[] ReadAsBytes() { diff --git a/Src/Newtonsoft.Json/JsonWriter.cs b/Src/Newtonsoft.Json/JsonWriter.cs index bbaa16c4..7555e293 100644 --- a/Src/Newtonsoft.Json/JsonWriter.cs +++ b/Src/Newtonsoft.Json/JsonWriter.cs @@ -505,7 +505,8 @@ namespace Newtonsoft.Json /// /// The value to write. /// A value is only required for tokens that have an associated value, e.g. the property name for . - /// A null value can be passed to the method for token's that don't have a value, e.g. . + /// null can be passed to the method for tokens that don't have a value, e.g. . + /// public void WriteToken(JsonToken token, object value) { switch (token) diff --git a/Src/Newtonsoft.Json/JsonWriterException.cs b/Src/Newtonsoft.Json/JsonWriterException.cs index 7c0f1b8c..c24169d5 100644 --- a/Src/Newtonsoft.Json/JsonWriterException.cs +++ b/Src/Newtonsoft.Json/JsonWriterException.cs @@ -66,7 +66,7 @@ namespace Newtonsoft.Json /// with a specified error message and a reference to the inner exception that is the cause of this exception. /// /// The error message that explains the reason for the exception. - /// The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + /// The exception that is the cause of the current exception, or null if no inner exception is specified. public JsonWriterException(string message, Exception innerException) : base(message, innerException) { @@ -78,8 +78,8 @@ namespace Newtonsoft.Json /// /// The that holds the serialized object data about the exception being thrown. /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). + /// The parameter is null. + /// The class name is null or is zero (0). public JsonWriterException(SerializationInfo info, StreamingContext context) : base(info, context) { diff --git a/Src/Newtonsoft.Json/Linq/JArray.cs b/Src/Newtonsoft.Json/Linq/JArray.cs index eb6fc7a6..e2b8aaea 100644 --- a/Src/Newtonsoft.Json/Linq/JArray.cs +++ b/Src/Newtonsoft.Json/Linq/JArray.cs @@ -120,7 +120,7 @@ namespace Newtonsoft.Json.Linq /// /// A that will be read for the content of the . /// The used to load the JSON. - /// If this is null, default load settings will be used. + /// If this is null, default load settings will be used. /// A that contains the JSON that was read from the specified . public new static JArray Load(JsonReader reader, JsonLoadSettings settings) { @@ -165,7 +165,7 @@ namespace Newtonsoft.Json.Linq /// /// A that contains JSON. /// The used to load the JSON. - /// If this is null, default load settings will be used. + /// If this is null, default load settings will be used. /// A populated from the string that contains JSON. /// /// @@ -363,7 +363,7 @@ namespace Newtonsoft.Json.Linq /// /// The object to locate in the . /// - /// true if is found in the ; otherwise, false. + /// true if is found in the ; otherwise, false. /// public bool Contains(JToken item) { @@ -383,7 +383,7 @@ namespace Newtonsoft.Json.Linq /// /// Gets a value indicating whether the is read-only. /// - /// true if the is read-only; otherwise, false. + /// true if the is read-only; otherwise, false. public bool IsReadOnly { get { return false; } @@ -394,7 +394,7 @@ namespace Newtonsoft.Json.Linq /// /// The object to remove from the . /// - /// true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + /// true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . /// /// The is read-only. public bool Remove(JToken item) diff --git a/Src/Newtonsoft.Json/Linq/JConstructor.cs b/Src/Newtonsoft.Json/Linq/JConstructor.cs index 1411caf6..83d57f9a 100644 --- a/Src/Newtonsoft.Json/Linq/JConstructor.cs +++ b/Src/Newtonsoft.Json/Linq/JConstructor.cs @@ -222,7 +222,7 @@ namespace Newtonsoft.Json.Linq /// /// A that will be read for the content of the . /// The used to load the JSON. - /// If this is null, default load settings will be used. + /// If this is null, default load settings will be used. /// A that contains the JSON that was read from the specified . public new static JConstructor Load(JsonReader reader, JsonLoadSettings settings) { diff --git a/Src/Newtonsoft.Json/Linq/JObject.cs b/Src/Newtonsoft.Json/Linq/JObject.cs index 96f1ed83..1993ed0f 100644 --- a/Src/Newtonsoft.Json/Linq/JObject.cs +++ b/Src/Newtonsoft.Json/Linq/JObject.cs @@ -256,7 +256,7 @@ namespace Newtonsoft.Json.Linq /// Gets a the specified name. /// /// The property name. - /// A with the specified name or null. + /// A with the specified name or null. public JProperty Property(string name) { if (name == null) @@ -360,7 +360,7 @@ namespace Newtonsoft.Json.Linq /// /// A that will be read for the content of the . /// The used to load the JSON. - /// If this is null, default load settings will be used. + /// If this is null, default load settings will be used. /// A that contains the JSON that was read from the specified . /// /// is not valid JSON. @@ -413,7 +413,7 @@ namespace Newtonsoft.Json.Linq /// /// A that contains JSON. /// The used to load the JSON. - /// If this is null, default load settings will be used. + /// If this is null, default load settings will be used. /// A populated from the string that contains JSON. /// /// is not valid JSON. diff --git a/Src/Newtonsoft.Json/Linq/JProperty.cs b/Src/Newtonsoft.Json/Linq/JProperty.cs index 3b15175b..bf1c1578 100644 --- a/Src/Newtonsoft.Json/Linq/JProperty.cs +++ b/Src/Newtonsoft.Json/Linq/JProperty.cs @@ -375,7 +375,7 @@ namespace Newtonsoft.Json.Linq /// /// A that will be read for the content of the . /// The used to load the JSON. - /// If this is null, default load settings will be used. + /// If this is null, default load settings will be used. /// A that contains the JSON that was read from the specified . public new static JProperty Load(JsonReader reader, JsonLoadSettings settings) { diff --git a/Src/Newtonsoft.Json/Linq/JToken.cs b/Src/Newtonsoft.Json/Linq/JToken.cs index 4e71bed4..22d07145 100644 --- a/Src/Newtonsoft.Json/Linq/JToken.cs +++ b/Src/Newtonsoft.Json/Linq/JToken.cs @@ -2093,7 +2093,7 @@ namespace Newtonsoft.Json.Linq /// /// An positioned at the token to read into this . /// The used to load the JSON. - /// If this is null, default load settings will be used. + /// If this is null, default load settings will be used. /// /// An that contains the token and its descendant tokens /// that were read from the reader. The runtime type of the token is determined @@ -2168,7 +2168,7 @@ namespace Newtonsoft.Json.Linq /// /// A that contains JSON. /// The used to load the JSON. - /// If this is null, default load settings will be used. + /// If this is null, default load settings will be used. /// A populated from the string that contains JSON. public static JToken Parse(string json, JsonLoadSettings settings) { @@ -2190,7 +2190,7 @@ namespace Newtonsoft.Json.Linq /// /// A positioned at the token to read into this . /// The used to load the JSON. - /// If this is null, default load settings will be used. + /// If this is null, default load settings will be used. /// /// A that contains the token and its descendant tokens /// that were read from the reader. The runtime type of the token is determined @@ -2286,7 +2286,7 @@ namespace Newtonsoft.Json.Linq /// /// A that contains a JPath expression. /// - /// A , or null. + /// A , or null. public JToken SelectToken(string path) { return SelectToken(path, false); diff --git a/Src/Newtonsoft.Json/Linq/JTokenEqualityComparer.cs b/Src/Newtonsoft.Json/Linq/JTokenEqualityComparer.cs index 33dd3f13..1c9dd536 100644 --- a/Src/Newtonsoft.Json/Linq/JTokenEqualityComparer.cs +++ b/Src/Newtonsoft.Json/Linq/JTokenEqualityComparer.cs @@ -50,7 +50,7 @@ namespace Newtonsoft.Json.Linq /// /// The for which a hash code is to be returned. /// A hash code for the specified object. - /// The type of is a reference type and is null. + /// The type of is a reference type and is null. public int GetHashCode(JToken obj) { if (obj == null) diff --git a/Src/Newtonsoft.Json/MemberSerialization.cs b/Src/Newtonsoft.Json/MemberSerialization.cs index 83099929..b3fd7d9e 100644 --- a/Src/Newtonsoft.Json/MemberSerialization.cs +++ b/Src/Newtonsoft.Json/MemberSerialization.cs @@ -50,7 +50,7 @@ namespace Newtonsoft.Json /// /// All public and private fields are serialized. Members can be excluded using or . /// This member serialization mode can also be set by marking the class with - /// and setting IgnoreSerializableAttribute on to false. + /// and setting IgnoreSerializableAttribute on to false. /// Fields = 2 #pragma warning restore 1584,1711,1572,1581,1580,1574 diff --git a/Src/Newtonsoft.Json/Schema/JsonSchemaException.cs b/Src/Newtonsoft.Json/Schema/JsonSchemaException.cs index 66e4748d..a674e704 100644 --- a/Src/Newtonsoft.Json/Schema/JsonSchemaException.cs +++ b/Src/Newtonsoft.Json/Schema/JsonSchemaException.cs @@ -82,7 +82,7 @@ namespace Newtonsoft.Json.Schema /// with a specified error message and a reference to the inner exception that is the cause of this exception. /// /// The error message that explains the reason for the exception. - /// The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + /// The exception that is the cause of the current exception, or null if no inner exception is specified. public JsonSchemaException(string message, Exception innerException) : base(message, innerException) { @@ -94,8 +94,8 @@ namespace Newtonsoft.Json.Schema /// /// The that holds the serialized object data about the exception being thrown. /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). + /// The parameter is null. + /// The class name is null or is zero (0). public JsonSchemaException(SerializationInfo info, StreamingContext context) : base(info, context) { diff --git a/Src/Newtonsoft.Json/Serialization/DefaultContractResolver.cs b/Src/Newtonsoft.Json/Serialization/DefaultContractResolver.cs index d3263d75..9ec84b23 100644 --- a/Src/Newtonsoft.Json/Serialization/DefaultContractResolver.cs +++ b/Src/Newtonsoft.Json/Serialization/DefaultContractResolver.cs @@ -211,7 +211,7 @@ namespace Newtonsoft.Json.Serialization /// If set to true the will use a cached shared with other resolvers of the same type. /// Sharing the cache will significantly improve performance with multiple resolver instances because expensive reflection will only /// happen once. This setting can cause unexpected behavior if different instances of the resolver are suppose to produce different - /// results. When set to false it is highly recommended to reuse instances with the . + /// results. When set to false it is highly recommended to reuse instances with the . /// [ObsoleteAttribute("DefaultContractResolver(bool) is obsolete. Use the parameterless constructor and cache instances of the contract resolver within your application for optimal performance.")] public DefaultContractResolver(bool shareCache) diff --git a/Src/Newtonsoft.Json/Serialization/IAttributeProvider.cs b/Src/Newtonsoft.Json/Serialization/IAttributeProvider.cs index 97a64693..b3517b74 100644 --- a/Src/Newtonsoft.Json/Serialization/IAttributeProvider.cs +++ b/Src/Newtonsoft.Json/Serialization/IAttributeProvider.cs @@ -36,7 +36,7 @@ namespace Newtonsoft.Json.Serialization /// /// Returns a collection of all of the attributes, or an empty collection if there are no attributes. /// - /// When true, look up the hierarchy chain for the inherited custom attribute. + /// When true, look up the hierarchy chain for the inherited custom attribute. /// A collection of s, or an empty collection. IList GetAttributes(bool inherit); @@ -44,7 +44,7 @@ namespace Newtonsoft.Json.Serialization /// Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. /// /// The type of the attributes. - /// When true, look up the hierarchy chain for the inherited custom attribute. + /// When true, look up the hierarchy chain for the inherited custom attribute. /// A collection of s, or an empty collection. IList GetAttributes(Type attributeType, bool inherit); } diff --git a/Src/Newtonsoft.Json/Serialization/JsonTypeReflector.cs b/Src/Newtonsoft.Json/Serialization/JsonTypeReflector.cs index ae1b5349..2d3f8b1b 100644 --- a/Src/Newtonsoft.Json/Serialization/JsonTypeReflector.cs +++ b/Src/Newtonsoft.Json/Serialization/JsonTypeReflector.cs @@ -177,7 +177,7 @@ namespace Newtonsoft.Json.Serialization /// /// The JsonConverter type to create. /// Optional arguments to pass to an initializing constructor of the JsonConverter. - /// If null, the default constructor is used. + /// If null, the default constructor is used. public static JsonConverter CreateJsonConverterInstance(Type converterType, object[] converterArgs) { Func converterCreator = CreatorCache.Get(converterType); diff --git a/Src/Newtonsoft.Json/Serialization/ReflectionAttributeProvider.cs b/Src/Newtonsoft.Json/Serialization/ReflectionAttributeProvider.cs index 5e9bc4ec..f98f9884 100644 --- a/Src/Newtonsoft.Json/Serialization/ReflectionAttributeProvider.cs +++ b/Src/Newtonsoft.Json/Serialization/ReflectionAttributeProvider.cs @@ -50,7 +50,7 @@ namespace Newtonsoft.Json.Serialization /// /// Returns a collection of all of the attributes, or an empty collection if there are no attributes. /// - /// When true, look up the hierarchy chain for the inherited custom attribute. + /// When true, look up the hierarchy chain for the inherited custom attribute. /// A collection of s, or an empty collection. public IList GetAttributes(bool inherit) { @@ -61,7 +61,7 @@ namespace Newtonsoft.Json.Serialization /// Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. /// /// The type of the attributes. - /// When true, look up the hierarchy chain for the inherited custom attribute. + /// When true, look up the hierarchy chain for the inherited custom attribute. /// A collection of s, or an empty collection. public IList GetAttributes(Type attributeType, bool inherit) { diff --git a/Src/Newtonsoft.Json/Utilities/CollectionUtils.cs b/Src/Newtonsoft.Json/Utilities/CollectionUtils.cs index bd504720..8aae3058 100644 --- a/Src/Newtonsoft.Json/Utilities/CollectionUtils.cs +++ b/Src/Newtonsoft.Json/Utilities/CollectionUtils.cs @@ -42,11 +42,11 @@ namespace Newtonsoft.Json.Utilities internal static class CollectionUtils { /// - /// Determines whether the collection is null or empty. + /// Determines whether the collection is null or empty. /// /// The collection. /// - /// true if the collection is null or empty; otherwise, false. + /// true if the collection is null or empty; otherwise, false. /// public static bool IsNullOrEmpty(ICollection collection) { diff --git a/Src/Newtonsoft.Json/Utilities/MethodBinder.cs b/Src/Newtonsoft.Json/Utilities/MethodBinder.cs index ee9af05e..cff02ad0 100644 --- a/Src/Newtonsoft.Json/Utilities/MethodBinder.cs +++ b/Src/Newtonsoft.Json/Utilities/MethodBinder.cs @@ -41,7 +41,7 @@ /// /// Source primitive type. /// Target primitive type. - /// True if source type can be widened to target type, false otherwise. + /// true if source type can be widened to target type, false otherwise. private static bool CanConvertPrimitive(Type from, Type to) { if (from == to) @@ -80,7 +80,7 @@ /// Method parameters. /// Argument types. /// Try to pack extra arguments into ParamArray. - /// True if method can be called with given arguments, false otherwise. + /// true if method can be called with given arguments, false otherwise. private static bool FilterParameters(ParameterInfo[] parameters, IList types, bool enableParamArray) { ValidationUtils.ArgumentNotNull(parameters, nameof(parameters)); diff --git a/Src/Newtonsoft.Json/Utilities/StringUtils.cs b/Src/Newtonsoft.Json/Utilities/StringUtils.cs index 938823e0..858e3040 100644 --- a/Src/Newtonsoft.Json/Utilities/StringUtils.cs +++ b/Src/Newtonsoft.Json/Utilities/StringUtils.cs @@ -75,7 +75,7 @@ namespace Newtonsoft.Json.Utilities } /// - /// Determines whether the string is all white space. Empty string will return false. + /// Determines whether the string is all white space. Empty string will return false. /// /// The string to test whether it is all white space. ///