From 0527568d0400219bc130f319a017dcc661eaf942 Mon Sep 17 00:00:00 2001
From: sta <sta.blockhead@gmail.com>
Date: Tue, 14 Jan 2014 03:29:43 +0900
Subject: [PATCH] Refactored Ext.cs

---
 websocket-sharp/Ext.cs | 593 ++++++++++++++++++++++-------------------
 1 file changed, 320 insertions(+), 273 deletions(-)

diff --git a/websocket-sharp/Ext.cs b/websocket-sharp/Ext.cs
index aad7adc2..4396dc08 100644
--- a/websocket-sharp/Ext.cs
+++ b/websocket-sharp/Ext.cs
@@ -15,7 +15,7 @@
  * Copyright (c) 2003 Ben Maurer
  * Copyright (c) 2003, 2005, 2009 Novell, Inc. (http://www.novell.com)
  * Copyright (c) 2009 Stephane Delcroix
- * Copyright (c) 2010-2013 sta.blockhead
+ * Copyright (c) 2010-2014 sta.blockhead
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -71,8 +71,7 @@ namespace WebSocketSharp
         //return new Byte [] { 0x00, 0x00, 0x00, 0xff, 0xff };
         return value;
 
-      using (var input = new MemoryStream (value))
-      {
+      using (var input = new MemoryStream (value)) {
         return input.compressToArray ();
       }
     }
@@ -84,8 +83,7 @@ namespace WebSocketSharp
         return output;
 
       stream.Position = 0;
-      using (var ds = new DeflateStream (output, CompressionMode.Compress, true))
-      {
+      using (var ds = new DeflateStream (output, CompressionMode.Compress, true)) {
         stream.CopyTo (ds);
         ds.Close (); // "BFINAL" set to 1.
         output.Position = 0;
@@ -96,8 +94,7 @@ namespace WebSocketSharp
 
     private static byte [] compressToArray (this Stream stream)
     {
-      using (var comp = stream.compress ())
-      {
+      using (var comp = stream.compress ()) {
         comp.Close ();
         return comp.ToArray ();
       }
@@ -108,8 +105,7 @@ namespace WebSocketSharp
       if (value.LongLength == 0)
         return value;
 
-      using (var input = new MemoryStream (value))
-      {
+      using (var input = new MemoryStream (value)) {
         return input.decompressToArray ();
       }
     }
@@ -121,8 +117,7 @@ namespace WebSocketSharp
         return output;
 
       stream.Position = 0;
-      using (var ds = new DeflateStream (stream, CompressionMode.Decompress, true))
-      {
+      using (var ds = new DeflateStream (stream, CompressionMode.Decompress, true)) {
         ds.CopyTo (output, true);
         return output;
       }
@@ -130,22 +125,21 @@ namespace WebSocketSharp
 
     private static byte [] decompressToArray (this Stream stream)
     {
-      using (var decomp = stream.decompress ())
-      {
+      using (var decomp = stream.decompress ()) {
         decomp.Close ();
         return decomp.ToArray ();
       }
     }
 
-    private static byte [] readBytes (this Stream stream, byte [] buffer, int offset, int length)
+    private static byte [] readBytes (
+      this Stream stream, byte [] buffer, int offset, int length)
     {
       var len = stream.Read (buffer, offset, length);
       if (len < 1)
         return buffer.SubArray (0, offset);
 
       var tmp = 0;
-      while (len < length)
-      {
+      while (len < length) {
         tmp = stream.Read (buffer, offset + len, length - len);
         if (tmp < 1)
           break;
@@ -303,7 +297,8 @@ namespace WebSocketSharp
       response.Close (HttpStatusCode.Unauthorized);
     }
 
-    internal static byte [] Compress (this byte [] value, CompressionMethod method)
+    internal static byte [] Compress (
+      this byte [] value, CompressionMethod method)
     {
       return method == CompressionMethod.DEFLATE
              ? value.compress ()
@@ -317,7 +312,8 @@ namespace WebSocketSharp
              : stream;
     }
 
-    internal static byte [] CompressToArray (this Stream stream, CompressionMethod method)
+    internal static byte [] CompressToArray (
+      this Stream stream, CompressionMethod method)
     {
       return method == CompressionMethod.DEFLATE
              ? stream.compressToArray ()
@@ -337,13 +333,13 @@ namespace WebSocketSharp
       src.CopyTo (dest, false);
     }
 
-    internal static void CopyTo (this Stream src, Stream dest, bool setDefaultPosition)
+    internal static void CopyTo (
+      this Stream src, Stream dest, bool setDefaultPosition)
     {
       var readLen = 0;
       var bufferLen = 256;
       var buffer = new byte [bufferLen];
-      while ((readLen = src.Read (buffer, 0, bufferLen)) > 0)
-      {
+      while ((readLen = src.Read (buffer, 0, bufferLen)) > 0) {
         dest.Write (buffer, 0, readLen);
       }
 
@@ -351,21 +347,24 @@ namespace WebSocketSharp
         dest.Position = 0;
     }
 
-    internal static byte [] Decompress (this byte [] value, CompressionMethod method)
+    internal static byte [] Decompress (
+      this byte [] value, CompressionMethod method)
     {
       return method == CompressionMethod.DEFLATE
              ? value.decompress ()
              : value;
     }
 
-    internal static Stream Decompress (this Stream stream, CompressionMethod method)
+    internal static Stream Decompress (
+      this Stream stream, CompressionMethod method)
     {
       return method == CompressionMethod.DEFLATE
              ? stream.decompress ()
              : stream;
     }
 
-    internal static byte [] DecompressToArray (this Stream stream, CompressionMethod method)
+    internal static byte [] DecompressToArray (
+      this Stream stream, CompressionMethod method)
     {
       return method == CompressionMethod.DEFLATE
              ? stream.decompressToArray ()
@@ -378,11 +377,13 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Determines whether the specified <see cref="int"/> equals the specified <see cref="char"/>,
-    /// and invokes the specified Action&lt;int&gt; delegate at the same time.
+    /// Determines whether the specified <see cref="int"/> equals the specified
+    /// <see cref="char"/>, and invokes the specified Action&lt;int&gt; delegate
+    /// at the same time.
     /// </summary>
     /// <returns>
-    /// <c>true</c> if <paramref name="value"/> equals <paramref name="c"/>; otherwise, <c>false</c>.
+    /// <c>true</c> if <paramref name="value"/> equals <paramref name="c"/>;
+    /// otherwise, <c>false</c>.
     /// </returns>
     /// <param name="value">
     /// An <see cref="int"/> to compare.
@@ -391,11 +392,12 @@ namespace WebSocketSharp
     /// A <see cref="char"/> to compare.
     /// </param>
     /// <param name="action">
-    /// An Action&lt;int&gt; delegate that references the method(s) called at the same time as comparing.
-    /// An <see cref="int"/> parameter to pass to the method(s) is <paramref name="value"/>.
+    /// An Action&lt;int&gt; delegate that references the method(s) called at the
+    /// same time as comparing. An <see cref="int"/> parameter to pass to the
+    /// method(s) is <paramref name="value"/>.
     /// </param>
     /// <exception cref="ArgumentOutOfRangeException">
-    /// <paramref name="value"/> is not between 0 and 255.
+    /// <paramref name="value"/> isn't between 0 and 255.
     /// </exception>
     internal static bool EqualsWith (this int value, char c, Action<int> action)
     {
@@ -410,11 +412,11 @@ namespace WebSocketSharp
     /// Gets the absolute path from the specified <see cref="Uri"/>.
     /// </summary>
     /// <returns>
-    /// A <see cref="string"/> that contains the absolute path if it is successfully found;
-    /// otherwise, <see langword="null"/>.
+    /// A <see cref="string"/> that represents the absolute path if it's
+    /// successfully found; otherwise, <see langword="null"/>.
     /// </returns>
     /// <param name="uri">
-    /// A <see cref="Uri"/> that contains a URI to get the absolute path from.
+    /// A <see cref="Uri"/> that represents a URI to get the absolute path from.
     /// </param>
     internal static string GetAbsolutePath (this Uri uri)
     {
@@ -454,7 +456,8 @@ namespace WebSocketSharp
                              : String.Empty;
     }
 
-    internal static string GetNameInternal (this string nameAndValue, string separator)
+    internal static string GetNameInternal (
+      this string nameAndValue, string separator)
     {
       int i = nameAndValue.IndexOf (separator);
       return i > 0
@@ -462,7 +465,8 @@ namespace WebSocketSharp
              : null;
     }
 
-    internal static string GetValueInternal (this string nameAndValue, string separator)
+    internal static string GetValueInternal (
+      this string nameAndValue, string separator)
     {
       int i = nameAndValue.IndexOf (separator);
       return i >= 0 && i < nameAndValue.Length - 1
@@ -505,8 +509,7 @@ namespace WebSocketSharp
     internal static bool IsText (this string value)
     {
       int len = value.Length;
-      for (int i = 0; i < len; i++)
-      {
+      for (int i = 0; i < len; i++) {
         char c = value [i];
         if (c < 0x20 && !"\r\n\t".Contains (c))
           return false;
@@ -514,8 +517,7 @@ namespace WebSocketSharp
         if (c == 0x7f)
           return false;
 
-        if (c == '\n' && ++i < len)
-        {
+        if (c == '\n' && ++i < len) {
           c = value [i];
           if (!" \t".Contains (c))
             return false;
@@ -597,19 +599,17 @@ namespace WebSocketSharp
       return stream.readBytes (new byte [length], 0, length);
     }
 
-    internal static byte [] ReadBytes (this Stream stream, long length, int bufferLength)
+    internal static byte [] ReadBytes (
+      this Stream stream, long length, int bufferLength)
     {
-      using (var result = new MemoryStream ())
-      {
+      using (var result = new MemoryStream ()) {
         var count = length / bufferLength;
         var rem = (int) (length % bufferLength);
 
         var buffer = new byte [bufferLength];
         var end = false;
-        for (long i = 0; i < count; i++)
-        {
-          if (!stream.readBytes (buffer, 0, bufferLength, result))
-          {
+        for (long i = 0; i < count; i++) {
+          if (!stream.readBytes (buffer, 0, bufferLength, result)) {
             end = true;
             break;
           }
@@ -624,38 +624,42 @@ namespace WebSocketSharp
     }
 
     internal static void ReadBytesAsync (
-      this Stream stream, int length, Action<byte []> completed, Action<Exception> error)
+      this Stream stream,
+      int length,
+      Action<byte []> completed,
+      Action<Exception> error)
     {
       var buffer = new byte [length];
-      AsyncCallback callback = ar =>
-      {
-        try {
-          var len = stream.EndRead (ar);
-          var bytes = len < 1
-                    ? new byte []{}
-                    : len < length
-                      ? stream.readBytes (buffer, len, length - len)
-                      : buffer;
-
-          if (completed != null)
-            completed (bytes);
-        }
-        catch (Exception ex) {
-          if (error != null)
-            error (ex);
-        }
-      };
-
-      stream.BeginRead (buffer, 0, length, callback, null);
+      stream.BeginRead (
+        buffer,
+        0,
+        length,
+        ar => {
+          try {
+            var len = stream.EndRead (ar);
+            var bytes = len < 1
+                      ? new byte [0]
+                      : len < length
+                        ? stream.readBytes (buffer, len, length - len)
+                        : buffer;
+
+            if (completed != null)
+              completed (bytes);
+          }
+          catch (Exception ex) {
+            if (error != null)
+              error (ex);
+          }
+        },
+        null);
     }
 
-    internal static string RemovePrefix (this string value, params string [] prefixes)
+    internal static string RemovePrefix (
+      this string value, params string [] prefixes)
     {
       int i = 0;
-      foreach (var prefix in prefixes)
-      {
-        if (value.StartsWith (prefix))
-        {
+      foreach (var prefix in prefixes) {
+        if (value.StartsWith (prefix)) {
           i = prefix.Length;
           break;
         }
@@ -666,32 +670,28 @@ namespace WebSocketSharp
              : value;
     }
 
-    internal static IEnumerable<string> SplitHeaderValue (this string value, params char [] separator)
+    internal static IEnumerable<string> SplitHeaderValue (
+      this string value, params char [] separator)
     {
       var separators = new string (separator);
       var buffer = new StringBuilder (64);
       int len = value.Length;
       bool quoted = false;
       bool escaped = false;
-      for (int i = 0; i < len; i++)
-      {
+      for (int i = 0; i < len; i++) {
         char c = value [i];
-        if (c == '"')
-        {
+        if (c == '"') {
           if (escaped)
             escaped = !escaped;
           else
             quoted = !quoted;
         }
-        else if (c == '\\')
-        {
+        else if (c == '\\') {
           if (i < len - 1 && value [i + 1] == '"')
             escaped = true;
         }
-        else if (separators.Contains (c))
-        {
-          if (!quoted)
-          {
+        else if (separators.Contains (c)) {
+          if (!quoted) {
             yield return buffer.ToString ();
             buffer.Length = 0;
             continue;
@@ -709,8 +709,7 @@ namespace WebSocketSharp
 
     internal static byte [] ToByteArray (this Stream stream)
     {
-      using (var output = new MemoryStream ())
-      {
+      using (var output = new MemoryStream ()) {
         stream.Position = 0;
         stream.CopyTo (output);
         output.Close ();
@@ -719,7 +718,8 @@ namespace WebSocketSharp
       }
     }
 
-    internal static byte [] ToByteArrayInternally (this ushort value, ByteOrder order)
+    internal static byte [] ToByteArrayInternally (
+      this ushort value, ByteOrder order)
     {
       var buffer = BitConverter.GetBytes (value);
       return order.IsHostOrder ()
@@ -727,7 +727,8 @@ namespace WebSocketSharp
              : buffer.Reverse ().ToArray ();
     }
 
-    internal static byte [] ToByteArrayInternally (this ulong value, ByteOrder order)
+    internal static byte [] ToByteArrayInternally (
+      this ulong value, ByteOrder order)
     {
       var buffer = BitConverter.GetBytes (value);
       return order.IsHostOrder ()
@@ -751,7 +752,8 @@ namespace WebSocketSharp
       return CompressionMethod.NONE;
     }
 
-    internal static System.Net.IPAddress ToIPAddress (this string hostNameOrAddress)
+    internal static System.Net.IPAddress ToIPAddress (
+      this string hostNameOrAddress)
     {
       try {
         var addrs = System.Net.Dns.GetHostAddresses (hostNameOrAddress);
@@ -781,71 +783,70 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Tries to create a <see cref="Uri"/> for WebSocket with the specified <paramref name="uriString"/>.
+    /// Tries to create a <see cref="Uri"/> for WebSocket with the specified
+    /// <paramref name="uriString"/>.
     /// </summary>
     /// <returns>
-    /// <c>true</c> if the <see cref="Uri"/> is successfully created; otherwise, <c>false</c>.
+    /// <c>true</c> if a <see cref="Uri"/> is successfully created; otherwise,
+    /// <c>false</c>.
     /// </returns>
     /// <param name="uriString">
-    /// A <see cref="string"/> that contains a WebSocket URL to try.
+    /// A <see cref="string"/> that represents the WebSocket URL to try.
     /// </param>
     /// <param name="result">
-    /// When this method returns, a <see cref="Uri"/> that represents the WebSocket URL
-    /// if <paramref name="uriString"/> is valid; otherwise, <see langword="null"/>.
+    /// When this method returns, a <see cref="Uri"/> that represents the
+    /// WebSocket URL if <paramref name="uriString"/> is valid; otherwise,
+    /// <see langword="null"/>.
     /// </param>
     /// <param name="message">
-    /// When this method returns, a <see cref="string"/> that contains an error message
-    /// if <paramref name="uriString"/> is invalid; otherwise, <c>String.Empty</c>.
+    /// When this method returns, a <see cref="string"/> that represents the
+    /// error message if <paramref name="uriString"/> is invalid; otherwise,
+    /// <see cref="String.Empty"/>.
     /// </param>
-    internal static bool TryCreateWebSocketUri (this string uriString, out Uri result, out string message)
+    internal static bool TryCreateWebSocketUri (
+      this string uriString, out Uri result, out string message)
     {
       result = null;
-      if (uriString.Length == 0)
-      {
+      if (uriString.Length == 0) {
         message = "Must not be empty.";
         return false;
       }
 
       var uri = uriString.ToUri ();
-      if (!uri.IsAbsoluteUri)
-      {
+      if (!uri.IsAbsoluteUri) {
         message = "Must be the absolute URI: " + uriString;
         return false;
       }
 
       var scheme = uri.Scheme;
-      if (scheme != "ws" && scheme != "wss")
-      {
+      if (scheme != "ws" && scheme != "wss") {
         message = "The scheme part must be 'ws' or 'wss': " + scheme;
         return false;
       }
 
       var fragment = uri.Fragment;
-      if (fragment.Length != 0)
-      {
+      if (fragment.Length > 0) {
         message = "Must not contain the fragment component: " + uriString;
         return false;
       }
 
       var port = uri.Port;
-      if (port > 0)
-      {
-        if (port > 65535)
-        {
+      if (port > 0) {
+        if (port > 65535) {
           message = "The port part must be between 1 and 65535: " + port;
           return false;
         }
 
-        if ((scheme == "ws" && port == 443) || (scheme == "wss" && port == 80))
-        {
-          message = String.Format ("Invalid pair of scheme and port: {0}, {1}", scheme, port);
+        if ((scheme == "ws" && port == 443) || (scheme == "wss" && port == 80)) {
+          message = String.Format (
+            "Invalid pair of scheme and port: {0}, {1}", scheme, port);
           return false;
         }
       }
-      else
-      {
+      else {
         port = scheme == "ws" ? 80 : 443;
-        var url = String.Format ("{0}://{1}:{2}{3}", scheme, uri.Host, port, uri.PathAndQuery);
+        var url = String.Format (
+          "{0}://{1}:{2}{3}", scheme, uri.Host, port, uri.PathAndQuery);
         uri = url.ToUri ();
       }
 
@@ -867,8 +868,7 @@ namespace WebSocketSharp
 
     internal static void WriteBytes (this Stream stream, byte [] value)
     {
-      using (var src = new MemoryStream (value))
-      {
+      using (var src = new MemoryStream (value)) {
         src.CopyTo (stream);
       }
     }
@@ -878,12 +878,12 @@ namespace WebSocketSharp
     #region Public Methods
 
     /// <summary>
-    /// Determines whether the specified <see cref="string"/> contains any of characters
-    /// in the specified array of <see cref="char"/>.
+    /// Determines whether the specified <see cref="string"/> contains any of
+    /// characters in the specified array of <see cref="char"/>.
     /// </summary>
     /// <returns>
-    /// <c>true</c> if <paramref name="value"/> contains any of <paramref name="chars"/>;
-    /// otherwise, <c>false</c>.
+    /// <c>true</c> if <paramref name="value"/> contains any of
+    /// <paramref name="chars"/>; otherwise, <c>false</c>.
     /// </returns>
     /// <param name="value">
     /// A <see cref="string"/> to test.
@@ -901,53 +901,55 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Determines whether the specified <see cref="NameValueCollection"/> contains the entry
-    /// with the specified <paramref name="name"/>.
+    /// Determines whether the specified <see cref="NameValueCollection"/>
+    /// contains the entry with the specified <paramref name="name"/>.
     /// </summary>
     /// <returns>
-    /// <c>true</c> if <paramref name="collection"/> contains the entry with <paramref name="name"/>;
-    /// otherwise, <c>false</c>.
+    /// <c>true</c> if <paramref name="collection"/> contains the entry with
+    /// <paramref name="name"/>; otherwise, <c>false</c>.
     /// </returns>
     /// <param name="collection">
     /// A <see cref="NameValueCollection"/> to test.
     /// </param>
     /// <param name="name">
-    /// A <see cref="string"/> that contains the key of the entry to find.
+    /// A <see cref="string"/> that represents the key of the entry to find.
     /// </param>
     public static bool Contains (this NameValueCollection collection, string name)
     {
-      return collection == null
+      return collection == null || collection.Count == 0
              ? false
              : collection [name] != null;
     }
 
     /// <summary>
-    /// Determines whether the specified <see cref="NameValueCollection"/> contains the entry
-    /// with the specified both <paramref name="name"/> and <paramref name="value"/>.
+    /// Determines whether the specified <see cref="NameValueCollection"/>
+    /// contains the entry with the specified both <paramref name="name"/> and
+    /// <paramref name="value"/>.
     /// </summary>
     /// <returns>
-    /// <c>true</c> if <paramref name="collection"/> contains the entry with both <paramref name="name"/>
-    /// and <paramref name="value"/>; otherwise, <c>false</c>.
+    /// <c>true</c> if <paramref name="collection"/> contains the entry with both
+    /// <paramref name="name"/> and <paramref name="value"/>; otherwise, <c>false</c>.
     /// </returns>
     /// <param name="collection">
     /// A <see cref="NameValueCollection"/> to test.
     /// </param>
     /// <param name="name">
-    /// A <see cref="string"/> that contains the key of the entry to find.
+    /// A <see cref="string"/> that represents the key of the entry to find.
     /// </param>
     /// <param name="value">
-    /// A <see cref="string"/> that contains the value of the entry to find.
+    /// A <see cref="string"/> that represents the value of the entry to find.
     /// </param>
-    public static bool Contains (this NameValueCollection collection, string name, string value)
+    public static bool Contains (
+      this NameValueCollection collection, string name, string value)
     {
-      if (collection == null)
+      if (collection == null || collection.Count == 0)
         return false;
 
       var values = collection [name];
       if (values == null)
         return false;
 
-      foreach (string v in values.Split (','))
+      foreach (var v in values.Split (','))
         if (v.Trim ().Equals (value, StringComparison.OrdinalIgnoreCase))
           return true;
 
@@ -955,7 +957,8 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Emits the specified <see cref="EventHandler"/> delegate if not <see langword="null"/>.
+    /// Emits the specified <see cref="EventHandler"/> delegate if it isn't
+    /// <see langword="null"/>.
     /// </summary>
     /// <param name="eventHandler">
     /// A <see cref="EventHandler"/> to emit.
@@ -974,16 +977,17 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Emits the specified <b>EventHandler&lt;TEventArgs&gt;</b> delegate if not <see langword="null"/>.
+    /// Emits the specified <c>EventHandler&lt;TEventArgs&gt;</c> delegate if it
+    /// isn't <see langword="null"/>.
     /// </summary>
     /// <param name="eventHandler">
-    /// An <b>EventHandler&lt;TEventArgs&gt;</b> to emit.
+    /// An <c>EventHandler&lt;TEventArgs&gt;</c> to emit.
     /// </param>
     /// <param name="sender">
     /// An <see cref="object"/> from which emits this <paramref name="eventHandler"/>.
     /// </param>
     /// <param name="e">
-    /// A <b>TEventArgs</b> that contains the event data.
+    /// A <c>TEventArgs</c> that represents the event data.
     /// </param>
     /// <typeparam name="TEventArgs">
     /// The type of the event data generated by the event.
@@ -997,19 +1001,23 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Gets the collection of cookies from the specified <see cref="NameValueCollection"/>.
+    /// Gets the collection of the HTTP Cookies from the specified HTTP
+    /// <paramref name="headers"/>.
     /// </summary>
     /// <returns>
-    /// A <see cref="CookieCollection"/> that receives a collection of the HTTP Cookies.
+    /// A <see cref="CookieCollection"/> that receives a collection of the HTTP
+    /// Cookies.
     /// </returns>
     /// <param name="headers">
-    /// A <see cref="NameValueCollection"/> that contains a collection of the HTTP Headers.
+    /// A <see cref="NameValueCollection"/> that contains a collection of the HTTP
+    /// Headers.
     /// </param>
     /// <param name="response">
-    /// <c>true</c> if gets from the response <paramref name="headers"/>;
-    /// from the request <paramref name="headers"/>, <c>false</c>.
+    /// <c>true</c> if <paramref name="headers"/> is a collection of the response
+    /// headers; otherwise, <c>false</c>.
     /// </param>
-    public static CookieCollection GetCookies (this NameValueCollection headers, bool response)
+    public static CookieCollection GetCookies (
+      this NameValueCollection headers, bool response)
     {
       var name = response ? "Set-Cookie" : "Cookie";
       return headers == null || !headers.Contains (name)
@@ -1018,13 +1026,15 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Gets the description of the HTTP status code using the specified <see cref="HttpStatusCode"/>.
+    /// Gets the description of the specified HTTP status <paramref name="code"/>.
     /// </summary>
     /// <returns>
-    /// A <see cref="string"/> that contains the description of an HTTP status code.
+    /// A <see cref="string"/> that represents the description of the HTTP status
+    /// code.
     /// </returns>
     /// <param name="code">
-    /// One of <see cref="HttpStatusCode"/> values that indicates an HTTP status code.
+    /// One of <see cref="HttpStatusCode"/> values that indicate the HTTP status
+    /// codes.
     /// </param>
     public static string GetDescription (this HttpStatusCode code)
     {
@@ -1032,40 +1042,45 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Gets the name from the specified <see cref="string"/> that contains a pair of name and value
-    /// separated by a separator string.
+    /// Gets the name from the specified <see cref="string"/> that contains a pair
+    /// of name and value separated by a separator string.
     /// </summary>
     /// <returns>
-    /// A <see cref="string"/> that contains the name if any; otherwise, <c>null</c>.
+    /// A <see cref="string"/> that represents the name if any; otherwise,
+    /// <c>null</c>.
     /// </returns>
     /// <param name="nameAndValue">
-    /// A <see cref="string"/> that contains a pair of name and value separated by a separator string.
+    /// A <see cref="string"/> that contains a pair of name and value separated by
+    /// a separator string.
     /// </param>
     /// <param name="separator">
-    /// A <see cref="string"/> that contains a separator string.
+    /// A <see cref="string"/> that represents a separator string.
     /// </param>
     public static string GetName (this string nameAndValue, string separator)
     {
-      return (nameAndValue != null && nameAndValue.Length != 0) &&
-             (separator != null && separator.Length != 0)
+      return (nameAndValue != null && nameAndValue.Length > 0) &&
+             (separator != null && separator.Length > 0)
              ? nameAndValue.GetNameInternal (separator)
              : null;
     }
 
     /// <summary>
-    /// Gets the name and value from the specified <see cref="string"/> that contains a pair of name and value
-    /// separated by a separator string.
+    /// Gets the name and value from the specified <see cref="string"/> that
+    /// contains a pair of name and value separated by a separator string.
     /// </summary>
     /// <returns>
-    /// A <b>KeyValuePair&lt;string, string&gt;</b> that contains the name and value if any.
+    /// A <c>KeyValuePair&lt;string, string&gt;</c> that represents the name and
+    /// value if any.
     /// </returns>
     /// <param name="nameAndValue">
-    /// A <see cref="string"/> that contains a pair of name and value separated by a separator string.
+    /// A <see cref="string"/> that contains a pair of name and value separated by
+    /// a separator string.
     /// </param>
     /// <param name="separator">
-    /// A <see cref="string"/> that contains a separator string.
+    /// A <see cref="string"/> that represents a separator string.
     /// </param>
-    public static KeyValuePair<string, string> GetNameAndValue (this string nameAndValue, string separator)
+    public static KeyValuePair<string, string> GetNameAndValue (
+      this string nameAndValue, string separator)
     {
       var name = nameAndValue.GetName (separator);
       var value = nameAndValue.GetValue (separator);
@@ -1075,18 +1090,18 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Gets the description of the HTTP status code using the specified <see cref="int"/>.
+    /// Gets the description of the specified HTTP status <paramref name="code"/>.
     /// </summary>
     /// <returns>
-    /// A <see cref="string"/> that contains the description of an HTTP status code.
+    /// A <see cref="string"/> that represents the description of the HTTP status
+    /// code.
     /// </returns>
     /// <param name="code">
-    /// An <see cref="int"/> that contains an HTTP status code.
+    /// An <see cref="int"/> that represents the HTTP status code.
     /// </param>
     public static string GetStatusDescription (this int code)
     {
-      switch (code)
-      {
+      switch (code) {
         case 100: return "Continue";
         case 101: return "Switching Protocols";
         case 102: return "Processing";
@@ -1139,22 +1154,24 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Gets the value from the specified <see cref="string"/> that contains a pair of name and value
-    /// separated by a separator string.
+    /// Gets the value from the specified <see cref="string"/> that contains
+    /// a pair of name and value separated by a separator string.
     /// </summary>
     /// <returns>
-    /// A <see cref="string"/> that contains the value if any; otherwise, <c>null</c>.
+    /// A <see cref="string"/> that represents the value if any; otherwise,
+    /// <c>null</c>.
     /// </returns>
     /// <param name="nameAndValue">
-    /// A <see cref="string"/> that contains a pair of name and value separated by a separator string.
+    /// A <see cref="string"/> that contains a pair of name and value separated by
+    /// a separator string.
     /// </param>
     /// <param name="separator">
-    /// A <see cref="string"/> that contains a separator string.
+    /// A <see cref="string"/> that represents a separator string.
     /// </param>
     public static string GetValue (this string nameAndValue, string separator)
     {
-      return (nameAndValue != null && nameAndValue.Length != 0) &&
-             (separator != null && separator.Length != 0)
+      return (nameAndValue != null && nameAndValue.Length > 0) &&
+             (separator != null && separator.Length > 0)
              ? nameAndValue.GetValueInternal (separator)
              : null;
     }
@@ -1192,7 +1209,8 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Determines whether the specified <see cref="string"/> is enclosed in the specified <see cref="char"/>.
+    /// Determines whether the specified <see cref="string"/> is enclosed in the
+    /// specified <see cref="char"/>.
     /// </summary>
     /// <returns>
     /// <c>true</c> if <paramref name="value"/> is enclosed in <paramref name="c"/>;
@@ -1202,7 +1220,7 @@ namespace WebSocketSharp
     /// A <see cref="string"/> to test.
     /// </param>
     /// <param name="c">
-    /// A <see cref="char"/> that contains character to find.
+    /// A <see cref="char"/> that represents the character to find.
     /// </param>
     public static bool IsEnclosedIn (this string value, char c)
     {
@@ -1213,10 +1231,12 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Determines whether the specified <see cref="ByteOrder"/> is host (this computer architecture) byte order.
+    /// Determines whether the specified <see cref="ByteOrder"/> is host (this
+    /// computer architecture) byte order.
     /// </summary>
     /// <returns>
-    /// <c>true</c> if <paramref name="order"/> is host byte order; otherwise, <c>false</c>.
+    /// <c>true</c> if <paramref name="order"/> is host byte order; otherwise,
+    /// <c>false</c>.
     /// </returns>
     /// <param name="order">
     /// A <see cref="ByteOrder"/> to test.
@@ -1229,8 +1249,8 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Determines whether the specified <see cref="System.Net.IPAddress"/> represents
-    /// the local IP address.
+    /// Determines whether the specified <see cref="System.Net.IPAddress"/>
+    /// represents the local IP address.
     /// </summary>
     /// <returns>
     /// <c>true</c> if <paramref name="address"/> represents the local IP address;
@@ -1261,10 +1281,12 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Determines whether the specified <see cref="string"/> is <see langword="null"/> or empty.
+    /// Determines whether the specified <see cref="string"/> is
+    /// <see langword="null"/> or empty.
     /// </summary>
     /// <returns>
-    /// <c>true</c> if <paramref name="value"/> is <see langword="null"/> or empty; otherwise, <c>false</c>.
+    /// <c>true</c> if <paramref name="value"/> is <see langword="null"/> or
+    /// empty; otherwise, <c>false</c>.
     /// </returns>
     /// <param name="value">
     /// A <see cref="string"/> to test.
@@ -1275,53 +1297,54 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Determines whether the specified <see cref="string"/> is a predefined scheme.
+    /// Determines whether the specified <see cref="string"/> is a predefined
+    /// scheme.
     /// </summary>
     /// <returns>
-    /// <c>true</c> if <paramref name="scheme"/> is a predefined scheme; otherwise, <c>false</c>.
+    /// <c>true</c> if <paramref name="value"/> is a predefined scheme; otherwise,
+    /// <c>false</c>.
     /// </returns>
-    /// <param name="scheme">
+    /// <param name="value">
     /// A <see cref="string"/> to test.
     /// </param>
-    public static bool IsPredefinedScheme (this string scheme)
+    public static bool IsPredefinedScheme (this string value)
     {
-      if (scheme == null && scheme.Length < 2)
+      if (value == null && value.Length < 2)
         return false;
 
-      char c = scheme [0];
+      var c = value [0];
       if (c == 'h')
-        return scheme == "http" || scheme == "https";
-
-      if (c == 'f')
-        return scheme == "file" || scheme == "ftp";
+        return value == "http" || value == "https";
 
       if (c == 'w')
-        return scheme == "ws" || scheme == "wss";
+        return value == "ws" || value == "wss";
+
+      if (c == 'f')
+        return value == "file" || value == "ftp";
 
-      if (c == 'n')
-      {
-        c = scheme [1];
+      if (c == 'n') {
+        c = value [1];
         return c == 'e'
-               ? scheme == "news" || scheme == "net.pipe" || scheme == "net.tcp"
-               : scheme == "nntp";
+               ? value == "news" || value == "net.pipe" || value == "net.tcp"
+               : value == "nntp";
       }
 
-      return (c == 'g' && scheme == "gopher") || (c == 'm' && scheme == "mailto");
+      return (c == 'g' && value == "gopher") || (c == 'm' && value == "mailto");
     }
 
     /// <summary>
-    /// Determines whether the specified <see cref="HttpListenerRequest"/> is an HTTP Upgrade request
-    /// to switch to the specified <paramref name="protocol"/>.
+    /// Determines whether the specified <see cref="HttpListenerRequest"/> is an
+    /// HTTP Upgrade request to switch to the specified <paramref name="protocol"/>.
     /// </summary>
     /// <returns>
-    /// <c>true</c> if <paramref name="request"/> is an HTTP Upgrade request
-    /// to switch to <paramref name="protocol"/>; otherwise, <c>false</c>.
+    /// <c>true</c> if <paramref name="request"/> is an HTTP Upgrade request to
+    /// switch to <paramref name="protocol"/>; otherwise, <c>false</c>.
     /// </returns>
     /// <param name="request">
-    /// A <see cref="HttpListenerRequest"/> that contains an HTTP request information.
+    /// A <see cref="HttpListenerRequest"/> that represents the HTTP request.
     /// </param>
     /// <param name="protocol">
-    /// A <see cref="string"/> that contains a protocol name.
+    /// A <see cref="string"/> that represents the protocol name.
     /// </param>
     /// <exception cref="ArgumentNullException">
     ///   <para>
@@ -1335,9 +1358,10 @@ namespace WebSocketSharp
     ///   </para>
     /// </exception>
     /// <exception cref="ArgumentException">
-    /// <paramref name="protocol"/> is <see cref="String.Empty"/>.
+    /// <paramref name="protocol"/> is empty.
     /// </exception>
-    public static bool IsUpgradeTo (this HttpListenerRequest request, string protocol)
+    public static bool IsUpgradeTo (
+      this HttpListenerRequest request, string protocol)
     {
       if (request == null)
         throw new ArgumentNullException ("request");
@@ -1356,24 +1380,25 @@ namespace WebSocketSharp
     /// Determines whether the specified <see cref="string"/> is a URI string.
     /// </summary>
     /// <returns>
-    /// <c>true</c> if <paramref name="uriString"/> is maybe a URI string; otherwise, <c>false</c>.
+    /// <c>true</c> if <paramref name="value"/> is maybe a URI string; otherwise,
+    /// <c>false</c>.
     /// </returns>
-    /// <param name="uriString">
+    /// <param name="value">
     /// A <see cref="string"/> to test.
     /// </param>
-    public static bool MaybeUri (this string uriString)
+    public static bool MaybeUri (this string value)
     {
-      if (uriString == null || uriString.Length == 0)
+      if (value == null || value.Length == 0)
         return false;
 
-      int p = uriString.IndexOf (':');
-      if (p == -1)
+      var i = value.IndexOf (':');
+      if (i == -1)
         return false;
 
-      if (p >= 10)
+      if (i >= 10)
         return false;
 
-      return uriString.Substring (0, p).IsPredefinedScheme ();
+      return value.Substring (0, i).IsPredefinedScheme ();
     }
 
     /// <summary>
@@ -1381,16 +1406,19 @@ namespace WebSocketSharp
     /// A sub-array starts at the specified element position.
     /// </summary>
     /// <returns>
-    /// An array of T that receives a sub-array, or an empty array of T if any problems with the parameters.
+    /// An array of T that receives a sub-array, or an empty array of T if any
+    /// problems with the parameters.
     /// </returns>
     /// <param name="array">
     /// An array of T that contains the data to retrieve a sub-array.
     /// </param>
     /// <param name="startIndex">
-    /// An <see cref="int"/> that contains the zero-based starting position of a sub-array in <paramref name="array"/>.
+    /// An <see cref="int"/> that contains the zero-based starting position of
+    /// a sub-array in <paramref name="array"/>.
     /// </param>
     /// <param name="length">
-    /// An <see cref="int"/> that contains the number of elements to retrieve a sub-array.
+    /// An <see cref="int"/> that contains the number of elements to retrieve
+    /// a sub-array.
     /// </param>
     /// <typeparam name="T">
     /// The type of elements in the <paramref name="array"/>.
@@ -1398,13 +1426,13 @@ namespace WebSocketSharp
     public static T [] SubArray<T> (this T [] array, int startIndex, int length)
     {
       if (array == null || array.Length == 0)
-        return new T []{};
+        return new T [0];
 
       if (startIndex < 0 || length <= 0)
-        return new T []{};
+        return new T [0];
 
       if (startIndex + length > array.Length)
-        return new T []{};
+        return new T [0];
 
       if (startIndex == 0 && array.Length == length)
         return array;
@@ -1416,7 +1444,8 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Executes the specified <see cref="Action"/> delegate <paramref name="n"/> times.
+    /// Executes the specified <see cref="Action"/> delegate <paramref name="n"/>
+    /// times.
     /// </summary>
     /// <param name="n">
     /// An <see cref="int"/> is the number of times to execute.
@@ -1431,7 +1460,8 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Executes the specified <see cref="Action"/> delegate <paramref name="n"/> times.
+    /// Executes the specified <see cref="Action"/> delegate <paramref name="n"/>
+    /// times.
     /// </summary>
     /// <param name="n">
     /// A <see cref="long"/> is the number of times to execute.
@@ -1439,14 +1469,15 @@ namespace WebSocketSharp
     /// <param name="act">
     /// An <see cref="Action"/> delegate that references the method(s) to execute.
     /// </param>
-    public static void Times( this long n, Action act)
+    public static void Times (this long n, Action act)
     {
       if (n > 0 && act != null)
         ((ulong) n).times (act);
     }
 
     /// <summary>
-    /// Executes the specified <see cref="Action"/> delegate <paramref name="n"/> times.
+    /// Executes the specified <see cref="Action"/> delegate <paramref name="n"/>
+    /// times.
     /// </summary>
     /// <param name="n">
     /// A <see cref="uint"/> is the number of times to execute.
@@ -1461,7 +1492,8 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Executes the specified <see cref="Action"/> delegate <paramref name="n"/> times.
+    /// Executes the specified <see cref="Action"/> delegate <paramref name="n"/>
+    /// times.
     /// </summary>
     /// <param name="n">
     /// A <see cref="ulong"/> is the number of times to execute.
@@ -1476,14 +1508,16 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Executes the specified <b>Action&lt;int&gt;</b> delegate <paramref name="n"/> times.
+    /// Executes the specified <c>Action&lt;int&gt;</c> delegate
+    /// <paramref name="n"/> times.
     /// </summary>
     /// <param name="n">
     /// An <see cref="int"/> is the number of times to execute.
     /// </param>
     /// <param name="act">
-    /// An <b>Action&lt;int&gt;</b> delegate that references the method(s) to execute.
-    /// An <see cref="int"/> parameter to pass to the method(s) is the zero-based count of iteration.
+    /// An <c>Action&lt;int&gt;</c> delegate that references the method(s) to
+    /// execute. An <see cref="int"/> parameter to pass to the method(s) is the
+    /// zero-based count of iteration.
     /// </param>
     public static void Times (this int n, Action<int> act)
     {
@@ -1493,14 +1527,16 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Executes the specified <b>Action&lt;long&gt;</b> delegate <paramref name="n"/> times.
+    /// Executes the specified <c>Action&lt;long&gt;</c> delegate
+    /// <paramref name="n"/> times.
     /// </summary>
     /// <param name="n">
     /// A <see cref="long"/> is the number of times to execute.
     /// </param>
     /// <param name="act">
-    /// An <b>Action&lt;long&gt;</b> delegate that references the method(s) to execute.
-    /// A <see cref="long"/> parameter to pass to the method(s) is the zero-based count of iteration.
+    /// An <c>Action&lt;long&gt;</c> delegate that references the method(s) to
+    /// execute. A <see cref="long"/> parameter to pass to the method(s) is the
+    /// zero-based count of iteration.
     /// </param>
     public static void Times (this long n, Action<long> act)
     {
@@ -1510,14 +1546,16 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Executes the specified <b>Action&lt;uint&gt;</b> delegate <paramref name="n"/> times.
+    /// Executes the specified <c>Action&lt;uint&gt;</c> delegate
+    /// <paramref name="n"/> times.
     /// </summary>
     /// <param name="n">
     /// A <see cref="uint"/> is the number of times to execute.
     /// </param>
     /// <param name="act">
-    /// An <b>Action&lt;uint&gt;</b> delegate that references the method(s) to execute.
-    /// A <see cref="uint"/> parameter to pass to the method(s) is the zero-based count of iteration.
+    /// An <c>Action&lt;uint&gt;</c> delegate that references the method(s) to
+    /// execute. A <see cref="uint"/> parameter to pass to the method(s) is the
+    /// zero-based count of iteration.
     /// </param>
     public static void Times (this uint n, Action<uint> act)
     {
@@ -1527,14 +1565,16 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Executes the specified <b>Action&lt;ulong&gt;</b> delegate <paramref name="n"/> times.
+    /// Executes the specified <c>Action&lt;ulong&gt;</c> delegate
+    /// <paramref name="n"/> times.
     /// </summary>
     /// <param name="n">
     /// A <see cref="ulong"/> is the number of times to execute.
     /// </param>
     /// <param name="act">
-    /// An <b>Action&lt;ulong&gt;</b> delegate that references the method(s) to execute.
-    /// A <see cref="ulong"/> parameter to pass to this method(s) is the zero-based count of iteration.
+    /// An <c>Action&lt;ulong&gt;</c> delegate that references the method(s) to
+    /// execute. A <see cref="ulong"/> parameter to pass to this method(s) is the
+    /// zero-based count of iteration.
     /// </param>
     public static void Times (this ulong n, Action<ulong> act)
     {
@@ -1544,12 +1584,13 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Converts the specified array of <see cref="byte"/> to the specified type data.
+    /// Converts the specified array of <see cref="byte"/> to the specified type
+    /// data.
     /// </summary>
     /// <returns>
-    /// A T converted from <paramref name="src"/>, or a default value of T
-    /// if <paramref name="src"/> is an empty array of <see cref="byte"/>
-    /// or if the type of T isn't <see cref="bool"/>, <see cref="char"/>, <see cref="double"/>,
+    /// A T converted from <paramref name="src"/>, or a default value of T if
+    /// <paramref name="src"/> is an empty array of <see cref="byte"/> or if the
+    /// type of T isn't <see cref="bool"/>, <see cref="char"/>, <see cref="double"/>,
     /// <see cref="float"/>, <see cref="int"/>, <see cref="long"/>, <see cref="short"/>,
     /// <see cref="uint"/>, <see cref="ulong"/> or <see cref="ushort"/>.
     /// </returns>
@@ -1557,7 +1598,8 @@ namespace WebSocketSharp
     /// An array of <see cref="byte"/> to convert.
     /// </param>
     /// <param name="srcOrder">
-    /// A <see cref="ByteOrder"/> that indicates the byte order of <paramref name="src"/>.
+    /// A <see cref="ByteOrder"/> that indicates the byte order of
+    /// <paramref name="src"/>.
     /// </param>
     /// <typeparam name="T">
     /// The type of the return. The T must be a value type.
@@ -1601,7 +1643,8 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Converts the specified <paramref name="value"/> to an array of <see cref="byte"/>.
+    /// Converts the specified <paramref name="value"/> to an array of
+    /// <see cref="byte"/>.
     /// </summary>
     /// <returns>
     /// An array of <see cref="byte"/> converted from <paramref name="value"/>.
@@ -1649,7 +1692,8 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Converts the order of the specified array of <see cref="byte"/> to the host byte order.
+    /// Converts the order of the specified array of <see cref="byte"/> to the
+    /// host byte order.
     /// </summary>
     /// <returns>
     /// An array of <see cref="byte"/> converted from <paramref name="src"/>.
@@ -1658,7 +1702,8 @@ namespace WebSocketSharp
     /// An array of <see cref="byte"/> to convert.
     /// </param>
     /// <param name="srcOrder">
-    /// A <see cref="WebSocketSharp.ByteOrder"/> that indicates the byte order of <paramref name="src"/>.
+    /// One of <see cref="ByteOrder"/> values that indicate the byte order of
+    /// <paramref name="src"/>.
     /// </param>
     /// <exception cref="ArgumentNullException">
     /// <paramref name="src"/> is <see langword="null"/>.
@@ -1674,18 +1719,19 @@ namespace WebSocketSharp
     }
 
     /// <summary>
-    /// Converts the specified <paramref name="array"/> to a <see cref="string"/> that concatenates
-    /// the each element of <paramref name="array"/> across the specified <paramref name="separator"/>.
+    /// Converts the specified <paramref name="array"/> to a <see cref="string"/>
+    /// that concatenates the each element of <paramref name="array"/> across the
+    /// specified <paramref name="separator"/>.
     /// </summary>
     /// <returns>
-    /// A <see cref="string"/> converted from <paramref name="array"/>, or a <see cref="String.Empty"/>
-    /// if <paramref name="array"/> is empty.
+    /// A <see cref="string"/> converted from <paramref name="array"/>, or
+    /// <see cref="String.Empty"/> if it's empty.
     /// </returns>
     /// <param name="array">
     /// An array of T to convert.
     /// </param>
     /// <param name="separator">
-    /// A <see cref="string"/> that contains a separator string.
+    /// A <see cref="string"/> that represents the separator string.
     /// </param>
     /// <typeparam name="T">
     /// The type of elements in <paramref name="array"/>.
@@ -1706,9 +1752,8 @@ namespace WebSocketSharp
         separator = String.Empty;
 
       var buffer = new StringBuilder (64);
-      (len - 1).Times (i =>
-        buffer.AppendFormat ("{0}{1}", array [i].ToString (), separator)
-      );
+      (len - 1).Times (
+        i => buffer.AppendFormat ("{0}{1}", array [i].ToString (), separator));
 
       buffer.Append (array [len - 1].ToString ());
       return buffer.ToString ();
@@ -1719,8 +1764,7 @@ namespace WebSocketSharp
     /// </summary>
     /// <returns>
     /// A <see cref="Uri"/> converted from <paramref name="uriString"/>, or
-    /// <see langword="null"/> if <paramref name="uriString"/> is
-    /// <see langword="null"/> or empty.
+    /// <see langword="null"/> if it's <see langword="null"/> or empty.
     /// </returns>
     /// <param name="uriString">
     /// A <see cref="string"/> to convert.
@@ -1738,49 +1782,52 @@ namespace WebSocketSharp
     /// URL-decodes the specified <see cref="string"/>.
     /// </summary>
     /// <returns>
-    /// A <see cref="string"/> that receives a decoded string, or the <paramref name="s"/>
-    /// if <paramref name="s"/> is <see langword="null"/> or <see cref="String.Empty"/>.
+    /// A <see cref="string"/> that receives the decoded string, or the
+    /// <paramref name="value"/> if it's <see langword="null"/> or empty.
     /// </returns>
-    /// <param name="s">
+    /// <param name="value">
     /// A <see cref="string"/> to decode.
     /// </param>
-    public static string UrlDecode (this string s)
+    public static string UrlDecode (this string value)
     {
-      return s == null || s.Length == 0
-             ? s
-             : HttpUtility.UrlDecode (s);
+      return value == null || value.Length == 0
+             ? value
+             : HttpUtility.UrlDecode (value);
     }
 
     /// <summary>
     /// URL-encodes the specified <see cref="string"/>.
     /// </summary>
     /// <returns>
-    /// A <see cref="string"/> that receives a encoded string, or the <paramref name="s"/>
-    /// if <paramref name="s"/> is <see langword="null"/> or <see cref="String.Empty"/>.
+    /// A <see cref="string"/> that receives the encoded string, or
+    /// <paramref name="value"/> if it's <see langword="null"/> or empty.
     /// </returns>
-    /// <param name="s">
+    /// <param name="value">
     /// A <see cref="string"/> to encode.
     /// </param>
-    public static string UrlEncode (this string s)
+    public static string UrlEncode (this string value)
     {
-      return s == null || s.Length == 0
-             ? s
-             : HttpUtility.UrlEncode (s);
+      return value == null || value.Length == 0
+             ? value
+             : HttpUtility.UrlEncode (value);
     }
 
     /// <summary>
-    /// Writes the specified content data using the specified <see cref="HttpListenerResponse"/>.
+    /// Writes the specified <paramref name="content"/> data using the specified
+    /// <see cref="HttpListenerResponse"/>.
     /// </summary>
     /// <param name="response">
-    /// A <see cref="HttpListenerResponse"/> that contains a network stream to write a content data.
+    /// A <see cref="HttpListenerResponse"/> that represents the HTTP response
+    /// used to write the content data.
     /// </param>
     /// <param name="content">
-    /// An array of <see cref="byte"/> that contains a content data to write.
+    /// An array of <see cref="byte"/> that contains the content data to write.
     /// </param>
     /// <exception cref="ArgumentNullException">
     /// <paramref name="response"/> is <see langword="null"/>.
     /// </exception>
-    public static void WriteContent (this HttpListenerResponse response, byte [] content)
+    public static void WriteContent (
+      this HttpListenerResponse response, byte [] content)
     {
       if (response == null)
         throw new ArgumentNullException ("response");