Improved documentation for Protocol::HTTP::Peer.

Author: ioquatix

lib/protocol/http/peer.rb

@@ -7,12 +7,18 @@ module Protocol
 	module HTTP
 		# Provide a well defined, cached representation of a peer (address).
 		class Peer
+			# Create a new peer object for the given IO object, using the remote address if available.
+			#
+			# @returns [Peer | Nil] The peer object, or nil if the remote address is not available.
 			def self.for(io)
 				if address = io.remote_address
 					return new(address)
 				end
 			end
 
+			# Initialize the peer with the given address.
+			#
+			# @parameter address [Addrinfo] The remote address of the peer.
 			def initialize(address)
 				@address = address
 
@@ -21,7 +27,10 @@ def initialize(address)
 				end
 			end
 
+			# @attribute [Addrinfo] The remote address of the peer.
 			attr :address
+			
+			# @attribute [String] The IP address of the peer, if available.
 			attr :ip_address
 
 			alias remote_address address