Minor improvements to documentation.

Author: ioquatix

lib/protocol/http1/body/chunked.rb

@@ -57,6 +57,7 @@ def read
 							if length == 0
 								read_trailer
 
+								# The final chunk has been read and the stream is now closed:
 								@stream = nil
 								@finished = true
 
@@ -75,6 +76,7 @@ def read
 							return chunk
 						end
 
+						# If the stream has been closed before we have read the final chunk, raise an error:
 						raise EOFError, "Stream closed before expected length was read!"
 					end
 				end

lib/protocol/http1/body/fixed.rb

@@ -11,6 +11,7 @@ module Body
 			class Fixed < HTTP::Body::Readable
 				def initialize(stream, length)
 					@stream = stream
+					
 					@length = length
 					@remaining = length
 				end
@@ -39,14 +40,15 @@ def close(error = nil)
 				def read
 					if @remaining > 0
 						if @stream
-							# `readpartial` will raise `EOFError` if the stream is closed/finished:
+							# `readpartial` will raise `EOFError` if the stream is finished, or `IOError` if the stream is closed.
 							if chunk = @stream.readpartial(@remaining)
 								@remaining -= chunk.bytesize
 
 								return chunk
 							end
 						end
 
+						# If the stream has been closed before we have read the expected length, raise an error:
 						raise EOFError, "Stream closed before expected length was read!"
 					end
 				end

lib/protocol/http1/body/remainder.rb

@@ -8,6 +8,7 @@
 module Protocol
 	module HTTP1
 		module Body
+			# A body that reads all remaining data from the stream.
 			class Remainder < HTTP::Body::Readable
 				BLOCK_SIZE = 1024 * 64
 
@@ -22,8 +23,8 @@ def empty?
 
 				def close(error = nil)
 					if @stream
-						@stream.close_read
 						# We can't really do anything in this case except close the connection.
+						@stream.close_read
 						@stream = nil
 					end