 
 // MARK: URLParser
 
-/// A parsing of HTTP URL according to the folowing format:
-///   
-/// scheme:[//[user:password@]host[:port]][/]path[?query][#fragment]
+/**
+ Splits and parses URLs into components - scheme, host, port, path, query string etc. according to the following format:
+
+**scheme:[//[user:password@]host[:port]][/]path[?query][#fragment]**
+
+### Usage Example: ###
+````swift
+ // Initialize a new URLParser instance, and check whether or not a connection has been established.
+ let url = "http://user:password@sample.host.com:8080/a/b/c?query=somestring#hash".data(using: .utf8)!
+ let urlParser = URLParser(url: url, isConnect: false)
+````
+*/
 public class URLParser : CustomStringConvertible {
 
-    /// Schema.
+    /// The schema of the URL.
     public var schema: String?
 
-    /// Hostname.
+    /// The host component of the URL.
     public var host: String?
     
     /// Path portion of the URL.
     public var path: String?
     
-    /// The entire query portion of the URL.
+    /// The query component of the URL.
     public var query: String?
     
     /// An optional fragment identifier providing direction to a secondary resource.

    /// The port specified, if any, in the URL.
    public var port: UInt16?
    
    /// The query parameters broken out.
    public var queryParameters: [String:String] = [:]
    
    /// Nicely formatted description of the parsed result.
    public var description: String {
        var desc = ""
        

        return desc
    }
    
    /**
    Initialize a new `URLParser` instance.
    
    - Parameter url: The URL to be parsed.
    - Parameter isConnect: A boolean, indicating whether or not a connection has been established.
    
    ### Usage Example: ###
    ````swift
    let parsedURL = URLParser(url: someURL, isConnect: false)
    ````
    */
    public init (url: Data, isConnect: Bool) {
        
        var parsedURL = http_parser_url_url()
