Changes as requested.

Author: ioquatix

.rdoc_options

@@ -1,3 +1,4 @@
 ---
 autolink_excluded_words:
 - Rack
+- CGI

SPEC.rdoc

@@ -34,7 +34,7 @@ The remainder of the request URL's "path", designating the virtual "location" of
 
 The <tt>PATH_INFO</tt>, if provided, must be a valid request target or an empty string, as defined by {RFC9110}[https://datatracker.ietf.org/doc/html/rfc9110#target.resource].
 * Only <tt>OPTIONS</tt> requests may have <tt>PATH_INFO</tt> set to <tt>*</tt> (asterisk-form).
-* Only <tt>CONNECT</tt> requests may have <tt>PATH_INFO</tt> set to an authority (authority-form). Note that in HTTP/2+, the authority-form is not a valid request target.
+* Only <tt>CONNECT</tt> requests may have <tt>PATH_INFO</tt> set to an authority (authority-form). Note that in <tt>HTTP/2+</tt>, the authority-form is not a valid request target.
 * <tt>CONNECT</tt> and <tt>OPTIONS</tt> requests must not have <tt>PATH_INFO</tt> set to a URI (absolute-form).
 * Otherwise, <tt>PATH_INFO</tt> must start with a <tt>/</tt> and must not include a fragment part starting with <tt>#</tt> (origin-form).
 
@@ -149,8 +149,8 @@ The input stream is an +IO+-like object which contains the raw HTTP request data
 * +read+ behaves like <tt>IO#read</tt>. Its signature is <tt>read([length, [buffer]])</tt>.
   * If given, +length+ must be a non-negative Integer (>= 0) or +nil+, and +buffer+ must be a +String+ and may not be +nil+.
   * If +length+ is given and not +nil+, then this method reads at most +length+ bytes from the input stream.
-  * If +length+ is not given or +nil+, then this method reads all data until <tt>EOF</tt>.
-  * When <tt>EOF</tt> is reached, this method returns +nil+ if +length+ is given and not +nil+, or +""+ if +length+ is not given or is +nil+.
+  * If +length+ is not given or +nil+, then this method reads all data until EOF.
+  * When EOF is reached, this method returns +nil+ if +length+ is given and not +nil+, or +""+ if +length+ is not given or is +nil+.
   * If +buffer+ is given, then the read data will be placed into +buffer+ instead of a newly created +String+.
 * +each+ must be called without arguments and only yield +String+ values.
 * +close+ can be called on the input stream to indicate that any remaining input is not needed.
@@ -205,9 +205,9 @@ This is an HTTP status. It must be an Integer greater than or equal to 100.
 The headers must be an unfrozen +Hash+. The header keys must be +String+ values. Special headers starting <tt>rack.</tt> are for communicating with the server, and must not be sent back to the client.
 
 * The headers must not contain a <tt>"status"</tt> key.
-* Header keys must conform to {RFC7230}[https://tools.ietf.org/html/rfc7230] token specification, i.e. cannot contain non-printable ASCII, <tt>DQUOTE</tt> or <tt>(),/:;<=>?@[\]{}</tt>.
+* Header keys must conform to {RFC7230}[https://tools.ietf.org/html/rfc7230] token specification, i.e. cannot contain non-printable <tt>ASCII</tt>, <tt>DQUOTE</tt> or <tt>(),/:;<=>?@[\]{}</tt>.
 * Header keys must not contain uppercase <tt>ASCII</tt> characters (A-Z).
-* Header values must be either a +String+, or an +Array+ of +String+ values, such that each +String+ must not contain characters with an ASCII ordinal below 040 (32).
+* Header values must be either a +String+, or an +Array+ of +String+ values, such that each +String+ must not contain characters with an <tt>ASCII</tt> ordinal below <tt>040</tt> (32).
 
 ==== The <tt>content-type</tt> Header
 
@@ -225,7 +225,7 @@ Setting this value informs the server that it should perform a connection upgrad
 
 === The Body
 
-The Body is typically an +Array+ of +String+ values, an enumerable that yields +String+ values, a +Proc+, or a +File+-like object.
+The Body is typically an +Array+ of +String+ values, an enumerable that yields +String+ values, a +Proc+, or an +IO+-like object.
 
 The Body must respond to +each+ or +call+. It may optionally respond to +to_path+ or +to_ary+. A Body that responds to +each+ is considered to be an Enumerable Body. A Body that responds to +call+ is considered to be a Streaming Body.
 

lib/rack/lint.rb

@@ -55,10 +55,6 @@ def call(env = nil)
 
     # N.B. The empty `##` comments creates paragraphs in the output. A trailing "\" is used to escape the newline character, which combines the comments into a single paragraph.
     #
-    # Formatting conventions for documentation:
-    # - Use <tt> for: literal values, constants, method signatures, environment keys, technical terms, BNF symbols.
-    # - Use + for: Ruby types, concepts, method names, class references.
-    #
     ## = Rack Specification
     ##
     ## This specification aims to formalize the Rack protocol. You can (and should) use +Rack::Lint+ to enforce it. When you develop middleware, be sure to test with +Rack::Lint+ to catch possible violations of this specification.
@@ -222,7 +218,7 @@ def check_environment(env)
               raise LintError, "Only CONNECT requests may have PATH_INFO set to an authority (authority-form)"
             end
           when REQUEST_PATH_ABSOLUTE_FORM
-            ## * <tt>CONNECT</tt> and <tt>OPTIONS</tt> requests must not have <tt>PATH_INFO</tt> set to a <tt>URI</tt> (absolute-form).
+            ## * <tt>CONNECT</tt> and <tt>OPTIONS</tt> requests must not have <tt>PATH_INFO</tt> set to a URI (absolute-form).
             if env[REQUEST_METHOD] == CONNECT || env[REQUEST_METHOD] == OPTIONS
               raise LintError, "CONNECT and OPTIONS requests must not have PATH_INFO set to a URI (absolute-form)"
             end
@@ -502,7 +498,7 @@ def initialize(input)
           @input = input
         end
 
-        ## * +gets+ must be called without arguments and return a +String+, or +nil+ on <tt>EOF</tt>.
+        ## * +gets+ must be called without arguments and return a +String+, or +nil+ on EOF (end-of-file).
         def gets(*args)
           raise LintError, "rack.input#gets called with arguments" unless args.size == 0
 
@@ -518,8 +514,8 @@ def gets(*args)
         ## * +read+ behaves like <tt>IO#read</tt>. Its signature is <tt>read([length, [buffer]])</tt>.
         ##   * If given, +length+ must be a non-negative Integer (>= 0) or +nil+, and +buffer+ must be a +String+ and may not be +nil+.
         ##   * If +length+ is given and not +nil+, then this method reads at most +length+ bytes from the input stream.
-        ##   * If +length+ is not given or +nil+, then this method reads all data until <tt>EOF</tt>.
-        ##   * When <tt>EOF</tt> is reached, this method returns +nil+ if +length+ is given and not +nil+, or +""+ if +length+ is not given or is +nil+.
+        ##   * If +length+ is not given or +nil+, then this method reads all data until EOF.
+        ##   * When EOF is reached, this method returns +nil+ if +length+ is given and not +nil+, or +""+ if +length+ is not given or is +nil+.
         ##   * If +buffer+ is given, then the read data will be placed into +buffer+ instead of a newly created +String+.
         def read(*args)
           unless args.size <= 2