     // Initialize the one time initialization struct to cause one time initializations to occur
     static private let oneTime = HTTPServerOneTimeInitializations()
 
+    /**
+     Creates an HTTP server object.
+     
+     ### Usage Example: ###
+     ````swift
+     let server = HTTPServer()
+     server.listen(on: 8080)
+     ````
+     */
     public init() {
         #if os(Linux)
             // On Linux, it is not possible to set SO_NOSIGPIPE on the socket, nor is it possible

        }
    }

    /// Static method to create a new HTTPServer and have it listen for connections.
    ///
    /// - Parameter port: port number for accepting new connections
    /// - Parameter delegate: the delegate handler for HTTP connections
    /// - Parameter errorHandler: optional callback for error handling
    ///
    /// - Returns: a new `HTTPServer` instance
    @available(*, deprecated, message: "use 'listen(on:delegate:) throws' with 'server.failed(callback:)' instead")
    public static func listen(port: Int, delegate: ServerDelegate, errorHandler: ((Swift.Error) -> Void)? = nil) -> HTTPServer {
        let server = HTTP.createServer()

        _ = HTTPServer.oneTime
    }

    /**
     Listens for connections on a socket.
     
     ### Usage Example: ###
     ````swift
     try server.listen(on: 8080)
     ````
     
     - Parameter on: Port number for new connections, e.g. 8080
     */
    public func listen(on port: Int) throws {
        self.port = port
        do {
