Fix documentation.

Author: ioquatix

lib/protocol/http/header/accept.rb

@@ -93,8 +93,7 @@ def to_s
 				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.
+				# @returns [Boolean] `false`, as Accept headers are used for response content negotiation.
 				def self.trailer?
 					false
 				end

lib/protocol/http/header/authorization.rb

@@ -31,13 +31,13 @@ def self.basic(username, password)
 					strict_base64_encoded = ["#{username}:#{password}"].pack("m0")
 
 					self.new(
-					"Basic #{strict_base64_encoded}"
-				)
+						"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.
+				# @returns [Boolean] `false`, as authorization headers must be in the header of the request to be useful.
 				def self.trailer?
 					false
 				end

lib/protocol/http/header/connection.rb

@@ -53,7 +53,7 @@ def upgrade?
 
 				# 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.
+				# @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

@@ -26,7 +26,7 @@ def to_h
 
 				# 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.
+				# @returns [Boolean] `false`, as cookie headers are needed during initial request processing.
 				def self.trailer?
 					false
 				end

lib/protocol/http/header/date.rb

@@ -28,7 +28,7 @@ def to_time
 
 				# 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.
+				# @returns [Boolean] `true`, as date headers are metadata that can be computed after response generation.
 				def self.trailer?
 					true
 				end

lib/protocol/http/header/digest.rb

@@ -59,8 +59,8 @@ def entries
 					end
 				end
 
-				# Digest headers are perfect for use as trailers since they contain
-				# integrity hashes that can only be calculated after the entire message body is available.
+				# Whether this header is acceptable in HTTP trailers.
+				# @returns [Boolean] `true`, as digest headers contain integrity hashes that can only be calculated after the entire message body is available.
 				def self.trailer?
 					true
 				end

lib/protocol/http/header/etag.rb

@@ -28,7 +28,7 @@ def weak?
 
 				# 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.
+				# @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

@@ -28,7 +28,7 @@ def to_s
 
 				# 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.
+				# @returns [Boolean] `false`, as most multiple-value headers should not appear in trailers by default.
 				def self.trailer?
 					false
 				end

lib/protocol/http/header/server_timing.rb

@@ -84,8 +84,8 @@ def metrics
 					end
 				end
 
-				# Server-Timing headers are safe to use as trailers since they contain
-				# performance metrics that are typically calculated during response generation.
+				# Whether this header is acceptable in HTTP trailers.
+				# @returns [Boolean] `true`, as server-timing headers contain performance metrics that are typically calculated during response generation.
 				def self.trailer?
 					true
 				end

lib/protocol/http/header/split.rb

@@ -42,7 +42,7 @@ def to_s
 
 				# 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.
+				# @returns [Boolean] `false`, as most comma-separated headers should not appear in trailers by default.
 				def self.trailer?
 					false
 				end