Documentation.

Author: ioquatix

lib/protocol/http/header/accept.rb

@@ -92,6 +92,9 @@ def to_s
 					join(",")
 				end
 
+				# Whether this header is acceptable in HTTP trailers.
+				# Accept headers in trailers can provide content negotiation hints for subsequent responses.
+				# @returns [Boolean] false, as Accept headers are generally not needed in trailers.
 				def self.trailer?
 					false
 				end

lib/protocol/http/header/authorization.rb

@@ -31,13 +31,16 @@ def self.basic(username, password)
 					strict_base64_encoded = ["#{username}:#{password}"].pack("m0")
 
 					self.new(
-						"Basic #{strict_base64_encoded}"
-					)
-				end
-				
-				def self.trailer?
-					false
-				end
+					"Basic #{strict_base64_encoded}"
+				)
+			end
+			
+			# Whether this header is acceptable in HTTP trailers.
+			# Authorization credentials must not appear in trailers for security reasons.
+			# @returns [Boolean] false, as authorization headers contain sensitive credentials.
+			def self.trailer?
+				false
+			end
 			end
 		end
 	end

lib/protocol/http/header/connection.rb

@@ -51,6 +51,9 @@ def upgrade?
 					self.include?(UPGRADE)
 				end
 
+				# Whether this header is acceptable in HTTP trailers.
+				# Connection headers control the current connection and must not appear in trailers.
+				# @returns [Boolean] false, as connection headers are hop-by-hop and forbidden in trailers.
 				def self.trailer?
 					false
 				end

lib/protocol/http/header/cookie.rb

@@ -24,6 +24,9 @@ def to_h
 					cookies.map{|cookie| [cookie.name, cookie]}.to_h
 				end
 
+				# Whether this header is acceptable in HTTP trailers.
+				# Cookie headers should not appear in trailers as they contain state information needed early in processing.
+				# @returns [Boolean] false, as cookie headers are needed during initial request processing.
 				def self.trailer?
 					false
 				end

lib/protocol/http/header/date.rb

@@ -26,6 +26,9 @@ def to_time
 					::Time.parse(self)
 				end
 
+				# Whether this header is acceptable in HTTP trailers.
+				# Date headers can safely appear in trailers as they provide metadata about response generation.
+				# @returns [Boolean] true, as date headers are metadata that can be computed after response generation.
 				def self.trailer?
 					true
 				end

lib/protocol/http/header/etag.rb

@@ -26,6 +26,9 @@ def weak?
 					self.start_with?("W/")
 				end
 
+				# Whether this header is acceptable in HTTP trailers.
+				# ETag headers can safely appear in trailers as they provide cache validation metadata.
+				# @returns [Boolean] true, as ETag headers are metadata that can be computed after response generation.
 				def self.trailer?
 					true
 				end

lib/protocol/http/header/multiple.rb

@@ -26,6 +26,9 @@ def to_s
 					join("\n")
 				end
 
+				# Whether this header is acceptable in HTTP trailers.
+				# This is a base class for headers with multiple values, default is to disallow in trailers.
+				# @returns [Boolean] false, as most multiple-value headers should not appear in trailers by default.
 				def self.trailer?
 					false
 				end

lib/protocol/http/header/split.rb

@@ -40,6 +40,9 @@ def to_s
 					join(",")
 				end
 
+				# Whether this header is acceptable in HTTP trailers.
+				# This is a base class for comma-separated headers, default is to disallow in trailers.
+				# @returns [Boolean] false, as most comma-separated headers should not appear in trailers by default.
 				def self.trailer?
 					false
 				end

lib/protocol/http/header/te.rb

@@ -119,6 +119,9 @@ def trailers?
 					self.any? {|value| value.start_with?(TRAILERS)}
 				end
 
+				# Whether this header is acceptable in HTTP trailers.
+				# TE headers negotiate transfer encodings and must not appear in trailers.
+				# @returns [Boolean] false, as TE headers are hop-by-hop and control message framing.
 				def self.trailer?
 					false
 				end

lib/protocol/http/header/trailer.rb

@@ -12,6 +12,9 @@ module Header
 			#
 			# This isn't a specific header  class is a utility for handling headers with comma-separated values, such as `accept`, `cache-control`, and other similar headers. The values are split and stored as an array internally, and serialized back to a comma-separated string when needed.
 			class Trailer < Split
+				# Whether this header is acceptable in HTTP trailers.
+				# Trailer headers themselves must not appear in trailers to avoid recursive references.
+				# @returns [Boolean] false, as Trailer headers control trailer processing and must appear before the message body.
 				def self.trailer?
 					false
 				end