net-http 0.3.2 → 0.4.0

data/lib/net/http/responses.rb

@@ -85,6 +85,8 @@ module Net
   #
   # A +Continue+ response indicates that the server has received the request headers.
   #
+  # :include: doc/net-http/included_getters.rdoc
+  #
   # References:
   #
   # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/100].
@@ -100,6 +102,8 @@ module Net
   # The <tt>Switching Protocol<tt> response indicates that the server has received
   # a request to switch protocols, and has agreed to do so.
   #
+  # :include: doc/net-http/included_getters.rdoc
+  #
   # References:
   #
   # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/101].
@@ -115,8 +119,11 @@ module Net
   # The +Processing+ response indicates that the server has received
   # and is processing the request, but no response is available yet.
   #
+  # :include: doc/net-http/included_getters.rdoc
+  #
   # References:
   #
+  # - {RFC 2518}[https://www.rfc-editor.org/rfc/rfc2518#section-10.1].
   # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#102].
   #
   class HTTPProcessing < HTTPInformation
@@ -129,9 +136,12 @@ module Net
   # and is processing the request, and contains certain headers;
   # the final response is not available yet.
   #
+  # :include: doc/net-http/included_getters.rdoc
+  #
   # References:
   #
   # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103].
+  # - {RFC 8297}[https://www.rfc-editor.org/rfc/rfc8297.html#section-2].
   # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#103].
   #
   class HTTPEarlyHints < HTTPInformation
@@ -142,7 +152,15 @@ module Net
   #
   # The +OK+ response indicates that the server has received
   # a request and has responded successfully.
-  # See {200 OK}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#200].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-200-ok].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#200].
+  #
   class HTTPOK < HTTPSuccess
     HAS_BODY = true
   end
@@ -151,7 +169,15 @@ module Net
   #
   # The +Created+ response indicates that the server has received
   # and has fulfilled a request to create a new resource.
-  # See {201 Created}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#201].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/201].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-201-created].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#201].
+  #
   class HTTPCreated < HTTPSuccess
     HAS_BODY = true
   end
@@ -160,7 +186,15 @@ module Net
   #
   # The +Accepted+ response indicates that the server has received
   # and is processing a request, but the processing has not yet been completed.
-  # See {202 Accepted}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#202].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/202].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-202-accepted].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#202].
+  #
   class HTTPAccepted < HTTPSuccess
     HAS_BODY = true
   end
@@ -171,7 +205,15 @@ module Net
   # is a transforming proxy (such as a Web accelerator)
   # that received a 200 OK response from its origin,
   # and is returning a modified version of the origin's response.
-  # See {203 Non-Authoritative Information}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#203].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/203].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-203-non-authoritative-infor].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#203].
+  #
   class HTTPNonAuthoritativeInformation < HTTPSuccess
     HAS_BODY = true
   end
@@ -180,7 +222,15 @@ module Net
   #
   # The <tt>No Content</tt> response indicates that the server
   # successfully processed the request, and is not returning any content.
-  # See {204 No Content}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#204].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/204].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-204-no-content].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#204].
+  #
   class HTTPNoContent < HTTPSuccess
     HAS_BODY = false
   end
@@ -190,7 +240,15 @@ module Net
   # The <tt>Reset Content</tt> response indicates that the server
   # successfully processed the request,
   # asks that the client reset its document view, and is not returning any content.
-  # See {205 Reset Content}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#205].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/205].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-205-reset-content].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#205].
+  #
   class HTTPResetContent < HTTPSuccess
     HAS_BODY = false
   end
@@ -200,7 +258,15 @@ module Net
   # The <tt>Partial Content</tt> response indicates that the server is delivering
   # only part of the resource (byte serving)
   # due to a Range header in the request.
-  # See {206 Partial Content}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#206].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/206].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-206-partial-content].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#206].
+  #
   class HTTPPartialContent < HTTPSuccess
     HAS_BODY = true
   end
@@ -210,7 +276,14 @@ module Net
   # The <tt>Multi-Status (WebDAV)</tt> response indicates that the server
   # has received the request,
   # and that the message body can contain a number of separate response codes.
-  # See {207 Multi-Status (WebDAV)}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#207].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {RFC 4818}[https://www.rfc-editor.org/rfc/rfc4918#section-11.1].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#207].
+  #
   class HTTPMultiStatus < HTTPSuccess
     HAS_BODY = true
   end
@@ -222,7 +295,14 @@ module Net
   # and that the members of a DAV binding have already been enumerated
   # in a preceding part of the (multi-status) response,
   # and are not being included again.
-  # See {208 Already Reported (WebDAV)}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#208].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {RFC 5842}[https://www.rfc-editor.org/rfc/rfc5842.html#section-7.1].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#208].
+  #
   class HTTPAlreadyReported < HTTPSuccess
     HAS_BODY = true
   end
@@ -232,7 +312,14 @@ module Net
   # The <tt>IM Used</tt> response indicates that the server has fulfilled a request
   # for the resource, and the response is a representation of the result
   # of one or more instance-manipulations applied to the current instance.
-  # See {226 IM Used}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#226].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {RFC 3229}[https://www.rfc-editor.org/rfc/rfc3229.html#section-10.4.1].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#226].
+  #
   class HTTPIMUsed < HTTPSuccess
     HAS_BODY = true
   end
@@ -241,7 +328,15 @@ module Net
   #
   # The <tt>Multiple Choices</tt> response indicates that the server
   # offers multiple options for the resource from which the client may choose.
-  # See {300 Multiple Choices}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#300].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/300].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-300-multiple-choices].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#300].
+  #
   class HTTPMultipleChoices < HTTPRedirection
     HAS_BODY = true
   end
@@ -251,7 +346,15 @@ module Net
   #
   # The <tt>Moved Permanently</tt> response indicates that links or records
   # returning this response should be updated to use the given URL.
-  # See {301 Moved Permanently}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#301].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/301].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-301-moved-permanently].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#301].
+  #
   class HTTPMovedPermanently < HTTPRedirection
     HAS_BODY = true
   end
@@ -260,7 +363,15 @@ module Net
   #
   # The <tt>Found</tt> response indicates that the client
   # should look at (browse to) another URL.
-  # See {302 Found}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#302].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/302].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-302-found].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#302].
+  #
   class HTTPFound < HTTPRedirection
     HAS_BODY = true
   end
@@ -269,7 +380,15 @@ module Net
   # Response class for <tt>See Other</tt> responses (status code 303).
   #
   # The response to the request can be found under another URI using the GET method.
-  # See {303 See Other}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#303].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/303].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-303-see-other].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#303].
+  #
   class HTTPSeeOther < HTTPRedirection
     HAS_BODY = true
   end
@@ -278,7 +397,15 @@ module Net
   #
   # Indicates that the resource has not been modified since the version
   # specified by the request headers.
-  # See {304 Not Modified}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#304].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/304].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-304-not-modified].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#304].
+  #
   class HTTPNotModified < HTTPRedirection
     HAS_BODY = false
   end
@@ -287,7 +414,14 @@ module Net
   #
   # The requested resource is available only through a proxy,
   # whose address is provided in the response.
-  # See {305 Use Proxy}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#305].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-305-use-proxy].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#305].
+  #
   class HTTPUseProxy < HTTPRedirection
     HAS_BODY = false
   end
@@ -296,7 +430,15 @@ module Net
   #
   # The request should be repeated with another URI;
   # however, future requests should still use the original URI.
-  # See {307 Temporary Redirect}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#307].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/307].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-307-temporary-redirect].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#307].
+  #
   class HTTPTemporaryRedirect < HTTPRedirection
     HAS_BODY = true
   end
@@ -304,7 +446,15 @@ module Net
   # Response class for <tt>Permanent Redirect</tt> responses (status code 308).
   #
   # This and all future requests should be directed to the given URI.
-  # See {308 Permanent Redirect}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#308].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/308].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-308-permanent-redirect].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#308].
+  #
   class HTTPPermanentRedirect < HTTPRedirection
     HAS_BODY = true
   end
@@ -312,7 +462,15 @@ module Net
   # Response class for <tt>Bad Request</tt> responses (status code 400).
   #
   # The server cannot or will not process the request due to an apparent client error.
-  # See {400 Bad Request}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#400].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-400-bad-request].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#400].
+  #
   class HTTPBadRequest < HTTPClientError
     HAS_BODY = true
   end
@@ -320,7 +478,15 @@ module Net
   # Response class for <tt>Unauthorized</tt> responses (status code 401).
   #
   # Authentication is required, but either was not provided or failed.
-  # See {401 Unauthorized}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#401].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-401-unauthorized].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#401].
+  #
   class HTTPUnauthorized < HTTPClientError
     HAS_BODY = true
   end
@@ -328,7 +494,15 @@ module Net
   # Response class for <tt>Payment Required</tt> responses (status code 402).
   #
   # Reserved for future use.
-  # See {402 Payment Required}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#402].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/402].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-402-payment-required].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#402].
+  #
   class HTTPPaymentRequired < HTTPClientError
     HAS_BODY = true
   end
@@ -337,7 +511,15 @@ module Net
   #
   # The request contained valid data and was understood by the server,
   # but the server is refusing action.
-  # See {403 Forbidden}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#403].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/403].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-403-forbidden].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#403].
+  #
   class HTTPForbidden < HTTPClientError
     HAS_BODY = true
   end
@@ -345,7 +527,15 @@ module Net
   # Response class for <tt>Not Found</tt> responses (status code 404).
   #
   # The requested resource could not be found but may be available in the future.
-  # See {404 Not Found}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#404].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-404-not-found].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#404].
+  #
   class HTTPNotFound < HTTPClientError
     HAS_BODY = true
   end
@@ -353,7 +543,15 @@ module Net
   # Response class for <tt>Method Not Allowed</tt> responses (status code 405).
   #
   # The request method is not supported for the requested resource.
-  # See {405 Method Not Allowed}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#405].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/405].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-405-method-not-allowed].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#405].
+  #
   class HTTPMethodNotAllowed < HTTPClientError
     HAS_BODY = true
   end
@@ -362,7 +560,15 @@ module Net
   #
   # The requested resource is capable of generating only content
   # that not acceptable according to the Accept headers sent in the request.
-  # See {406 Not Acceptable}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#406].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/406].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-406-not-acceptable].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#406].
+  #
   class HTTPNotAcceptable < HTTPClientError
     HAS_BODY = true
   end
@@ -370,7 +576,15 @@ module Net
   # Response class for <tt>Proxy Authentication Required</tt> responses (status code 407).
   #
   # The client must first authenticate itself with the proxy.
-  # See {407 Proxy Authentication Required}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#407].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/407].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-407-proxy-authentication-re].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#407].
+  #
   class HTTPProxyAuthenticationRequired < HTTPClientError
     HAS_BODY = true
   end
@@ -378,7 +592,15 @@ module Net
   # Response class for <tt>Request Timeout</tt> responses (status code 408).
   #
   # The server timed out waiting for the request.
-  # See {408 Request Timeout}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#408].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-408-request-timeout].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#408].
+  #
   class HTTPRequestTimeout < HTTPClientError
     HAS_BODY = true
   end
@@ -387,7 +609,15 @@ module Net
   # Response class for <tt>Conflict</tt> responses (status code 409).
   #
   # The request could not be processed because of conflict in the current state of the resource.
-  # See {409 Conflict}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#409].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/409].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-409-conflict].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#409].
+  #
   class HTTPConflict < HTTPClientError
     HAS_BODY = true
   end
@@ -396,7 +626,15 @@ module Net
   #
   # The resource requested was previously in use but is no longer available
   # and will not be available again.
-  # See {410 Gone}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#410].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/410].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-410-gone].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#410].
+  #
   class HTTPGone < HTTPClientError
     HAS_BODY = true
   end
@@ -405,7 +643,15 @@ module Net
   #
   # The request did not specify the length of its content,
   # which is required by the requested resource.
-  # See {411 Length Required}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#411].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/411].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-411-length-required].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#411].
+  #
   class HTTPLengthRequired < HTTPClientError
     HAS_BODY = true
   end
@@ -414,7 +660,15 @@ module Net
   #
   # The server does not meet one of the preconditions
   # specified in the request headers.
-  # See {412 Precondition Failed}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#412].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/412].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-412-precondition-failed].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#412].
+  #
   class HTTPPreconditionFailed < HTTPClientError
     HAS_BODY = true
   end
@@ -422,7 +676,15 @@ module Net
   # Response class for <tt>Payload Too Large</tt> responses (status code 413).
   #
   # The request is larger than the server is willing or able to process.
-  # See {413 Payload Too Large}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#413].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/413].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-413-content-too-large].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#413].
+  #
   class HTTPPayloadTooLarge < HTTPClientError
     HAS_BODY = true
   end
@@ -431,7 +693,15 @@ module Net
   # Response class for <tt>URI Too Long</tt> responses (status code 414).
   #
   # The URI provided was too long for the server to process.
-  # See {414 URI Too Long}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#414].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/414].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-414-uri-too-long].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#414].
+  #
   class HTTPURITooLong < HTTPClientError
     HAS_BODY = true
   end
@@ -441,7 +711,15 @@ module Net
   # Response class for <tt>Unsupported Media Type</tt> responses (status code 415).
   #
   # The request entity has a media type which the server or resource does not support.
-  # See {415 Unsupported Media Type}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#415].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/415].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-415-unsupported-media-type].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#415].
+  #
   class HTTPUnsupportedMediaType < HTTPClientError
     HAS_BODY = true
   end
@@ -449,7 +727,15 @@ module Net
   # Response class for <tt>Range Not Satisfiable</tt> responses (status code 416).
   #
   # The request entity has a media type which the server or resource does not support.
-  # See {416 Range Not Satisfiable}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#416].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/416].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-416-range-not-satisfiable].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#416].
+  #
   class HTTPRangeNotSatisfiable < HTTPClientError
     HAS_BODY = true
   end
@@ -458,7 +744,15 @@ module Net
   # Response class for <tt>Expectation Failed</tt> responses (status code 417).
   #
   # The server cannot meet the requirements of the Expect request-header field.
-  # See {417 Expectation Failed}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#417].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/417].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-417-expectation-failed].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#417].
+  #
   class HTTPExpectationFailed < HTTPClientError
     HAS_BODY = true
   end
@@ -471,7 +765,14 @@ module Net
   # Response class for <tt>Misdirected Request</tt> responses (status code 421).
   #
   # The request was directed at a server that is not able to produce a response.
-  # See {421 Misdirected Request}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#421].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-421-misdirected-request].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#421].
+  #
   class HTTPMisdirectedRequest < HTTPClientError
     HAS_BODY = true
   end
@@ -479,7 +780,15 @@ module Net
   # Response class for <tt>Unprocessable Entity</tt> responses (status code 422).
   #
   # The request was well-formed but had semantic errors.
-  # See {422 Unprocessable Entity}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#422].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-422-unprocessable-content].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#422].
+  #
   class HTTPUnprocessableEntity < HTTPClientError
     HAS_BODY = true
   end
@@ -487,7 +796,14 @@ module Net
   # Response class for <tt>Locked (WebDAV)</tt> responses (status code 423).
   #
   # The requested resource is locked.
-  # See {423 Locked (WebDAV)}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#423].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {RFC 4918}[https://www.rfc-editor.org/rfc/rfc4918#section-11.3].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#423].
+  #
   class HTTPLocked < HTTPClientError
     HAS_BODY = true
   end
@@ -496,6 +812,14 @@ module Net
   #
   # The request failed because it depended on another request and that request failed.
   # See {424 Failed Dependency (WebDAV)}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#424].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {RFC 4918}[https://www.rfc-editor.org/rfc/rfc4918#section-11.4].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#424].
+  #
   class HTTPFailedDependency < HTTPClientError
     HAS_BODY = true
   end
@@ -506,7 +830,15 @@ module Net
   # Response class for <tt>Upgrade Required</tt> responses (status code 426).
   #
   # The client should switch to the protocol given in the Upgrade header field.
-  # See {426 Upgrade Required}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#426].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/426].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-426-upgrade-required].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#426].
+  #
   class HTTPUpgradeRequired < HTTPClientError
     HAS_BODY = true
   end
@@ -514,7 +846,15 @@ module Net
   # Response class for <tt>Precondition Required</tt> responses (status code 428).
   #
   # The origin server requires the request to be conditional.
-  # See {428 Precondition Required}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#428].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/428].
+  # - {RFC 6585}[https://www.rfc-editor.org/rfc/rfc6585#section-3].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#428].
+  #
   class HTTPPreconditionRequired < HTTPClientError
     HAS_BODY = true
   end
@@ -522,7 +862,15 @@ module Net
   # Response class for <tt>Too Many Requests</tt> responses (status code 429).
   #
   # The user has sent too many requests in a given amount of time.
-  # See {429 Too Many Requests}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#429].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429].
+  # - {RFC 6585}[https://www.rfc-editor.org/rfc/rfc6585#section-4].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#429].
+  #
   class HTTPTooManyRequests < HTTPClientError
     HAS_BODY = true
   end
@@ -531,7 +879,15 @@ module Net
   #
   # An individual header field is too large,
   # or all the header fields collectively, are too large.
-  # See {431 Request Header Fields Too Large}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#431].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/431].
+  # - {RFC 6585}[https://www.rfc-editor.org/rfc/rfc6585#section-5].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#431].
+  #
   class HTTPRequestHeaderFieldsTooLarge < HTTPClientError
     HAS_BODY = true
   end
@@ -540,7 +896,15 @@ module Net
   #
   # A server operator has received a legal demand to deny access to a resource or to a set of resources
   # that includes the requested resource.
-  # See {451 Unavailable For Legal Reasons}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#451].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/451].
+  # - {RFC 7725}[https://www.rfc-editor.org/rfc/rfc7725.html#section-3].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#451].
+  #
   class HTTPUnavailableForLegalReasons < HTTPClientError
     HAS_BODY = true
   end
@@ -552,7 +916,15 @@ module Net
   # Response class for <tt>Internal Server Error</tt> responses (status code 500).
   #
   # An unexpected condition was encountered and no more specific message is suitable.
-  # See {500 Internal Server Error}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#500].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-500-internal-server-error].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#500].
+  #
   class HTTPInternalServerError < HTTPServerError
     HAS_BODY = true
   end
@@ -561,7 +933,15 @@ module Net
   #
   # The server either does not recognize the request method,
   # or it lacks the ability to fulfil the request.
-  # See {501 Not Implemented}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#501].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/501].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-501-not-implemented].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#501].
+  #
   class HTTPNotImplemented < HTTPServerError
     HAS_BODY = true
   end
@@ -570,7 +950,15 @@ module Net
   #
   # The server was acting as a gateway or proxy
   # and received an invalid response from the upstream server.
-  # See {502 Bad Gateway}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#502].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-502-bad-gateway].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#502].
+  #
   class HTTPBadGateway < HTTPServerError
     HAS_BODY = true
   end
@@ -579,7 +967,15 @@ module Net
   #
   # The server cannot handle the request
   # (because it is overloaded or down for maintenance).
-  # See {503 Service Unavailable}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#503].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/503].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-503-service-unavailable].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#503].
+  #
   class HTTPServiceUnavailable < HTTPServerError
     HAS_BODY = true
   end
@@ -588,7 +984,15 @@ module Net
   #
   # The server was acting as a gateway or proxy
   # and did not receive a timely response from the upstream server.
-  # See {504 Gateway Timeout}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#504].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/504].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-504-gateway-timeout].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#504].
+  #
   class HTTPGatewayTimeout < HTTPServerError
     HAS_BODY = true
   end
@@ -597,7 +1001,15 @@ module Net
   # Response class for <tt>HTTP Version Not Supported</tt> responses (status code 505).
   #
   # The server does not support the HTTP version used in the request.
-  # See {505 HTTP Version Not Supported}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#505].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/505].
+  # - {RFC 9110}[https://www.rfc-editor.org/rfc/rfc9110.html#name-505-http-version-not-suppor].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#505].
+  #
   class HTTPVersionNotSupported < HTTPServerError
     HAS_BODY = true
   end
@@ -605,7 +1017,15 @@ module Net
   # Response class for <tt>Variant Also Negotiates</tt> responses (status code 506).
   #
   # Transparent content negotiation for the request results in a circular reference.
-  # See {506 Variant Also Negotiates}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#506].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/506].
+  # - {RFC 2295}[https://www.rfc-editor.org/rfc/rfc2295#section-8.1].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#506].
+  #
   class HTTPVariantAlsoNegotiates < HTTPServerError
     HAS_BODY = true
   end
@@ -613,7 +1033,15 @@ module Net
   # Response class for <tt>Insufficient Storage (WebDAV)</tt> responses (status code 507).
   #
   # The server is unable to store the representation needed to complete the request.
-  # See {507 Insufficient Storage (WebDAV)}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#507].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/507].
+  # - {RFC 4918}[https://www.rfc-editor.org/rfc/rfc4918#section-11.5].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#507].
+  #
   class HTTPInsufficientStorage < HTTPServerError
     HAS_BODY = true
   end
@@ -621,7 +1049,15 @@ module Net
   # Response class for <tt>Loop Detected (WebDAV)</tt> responses (status code 508).
   #
   # The server detected an infinite loop while processing the request.
-  # See {508 Loop Detected (WebDAV)}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#508].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/508].
+  # - {RFC 5942}[https://www.rfc-editor.org/rfc/rfc5842.html#section-7.2].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#508].
+  #
   class HTTPLoopDetected < HTTPServerError
     HAS_BODY = true
   end
@@ -630,7 +1066,15 @@ module Net
   # Response class for <tt>Not Extended</tt> responses (status code 510).
   #
   # Further extensions to the request are required for the server to fulfill it.
-  # See {510 Not Extended}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#510].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/510].
+  # - {RFC 2774}[https://www.rfc-editor.org/rfc/rfc2774.html#section-7].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#510].
+  #
   class HTTPNotExtended < HTTPServerError
     HAS_BODY = true
   end
@@ -638,7 +1082,15 @@ module Net
   # Response class for <tt>Network Authentication Required</tt> responses (status code 511).
   #
   # The client needs to authenticate to gain network access.
-  # See {511 Network Authentication Required}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#511].
+  #
+  # :include: doc/net-http/included_getters.rdoc
+  #
+  # References:
+  #
+  # - {Mozilla}[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/511].
+  # - {RFC 6585}[https://www.rfc-editor.org/rfc/rfc6585#section-6].
+  # - {Wikipedia}[https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#511].
+  #
   class HTTPNetworkAuthenticationRequired < HTTPServerError
     HAS_BODY = true
   end