         /// Specifies the host name to be used in the URL of request
         case hostname(String)
         
-        /// Specifies the port to be used in the URL of request
+        /// Specifies the port to be used in the URL of request.
+        ///
+        /// Note that an Int16 is incapable of representing all possible port values, however
+        /// it forms part of the Kitura-net 2.0 API. In order to pass a port number greater
+        /// than 32,767 (Int16.max), use the following code:
+        /// ```
+        /// let portNumber: UInt16 = 65535
+        /// let portOption: ClientRequest.Options = .port(Int16(bitPattern: portNumber))
+        /// ```
         case port(Int16)
         
         /// Specifies the path to be used in the URL of request


import Foundation

// MARK: ClientRequest
/**
This class provides a set of low level APIs for issuing HTTP requests to another server. A new instance of the request can be created, along with options if the user would like to specify certain parameters such as HTTP headers, HTTP methods, host names, and SSL credentials. `Data` and `String` objects cab be added to a `ClientRequest` too, and URLs can be parsed.

        }
        options.append(.path(fullPath))
        if let port = url.port {
            options.append(.port(Int16(bitPattern: UInt16(port))))
        }
        if let username = url.user {
            options.append(.username(username))
