You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by bu...@apache.org on 2026/06/18 14:25:56 UTC

[Bug 70119] New: HTTP/2 guide: “its RFC 9113”

https://bz.apache.org/bugzilla/show_bug.cgi?id=70119

            Bug ID: 70119
           Summary: HTTP/2 guide: “its RFC 9113”
           Product: Apache httpd-2
           Version: 2.5-HEAD
          Hardware: All
               URL: https://httpd.apache.org/docs/trunk/en/howto/http2.htm
                    l
                OS: All
            Status: NEW
          Severity: trivial
          Priority: P4
         Component: Documentation
          Assignee: docs@httpd.apache.org
          Reporter: chealer@gmail.com
  Target Milestone: ---

The “The HTTP/2 protocol” section of the “HTTP/2 guide” page contains:
> There has been a lot written about HTTP/2 and how it works. The most normative is, of course, its RFC 9113 (which obsoletes the original RFC 7540).
> 
The part following the last comma has incorrect syntax, since “its” should
precede something countable, but “RFC 9113”, which means *the* RFC numbered
9113, can never have more than 1 instance.

I suggest either:
1. “its specification (RFC 9113)”
2. just “its RFC”

By the way, the list says “h2c is HTTP/2 over TCP”. That is not technically
incorrect, but presenting that as a definition is misleading, as the "h2c"
protocol identifier “describes a protocol that does not use TLS”.

🅭🄍: https://www.philippecloutier.com/Common+infrastructure+licensing#its

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


[Bug 70119] HTTP/2 guide: “its RFC 9113”

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70119

Philippe Cloutier <ch...@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEEDINFO                    |NEW

--- Comment #2 from Philippe Cloutier <ch...@gmail.com> ---
(In reply to Rich Bowen from comment #1)
> I don't understand the phrase "should precede something countable". One is
> countable, so I presume you're saying something different than that. 9113 is
> indeed its RFC - the RFC describing HTTP/2.
There are several RFCs specifying HTTP/2, including 7540 and 9113. Saying “its
RFC 9113” is syntactically valid, but it suggests that refers to the 9113th
HTTP RFC. In reality, the vast majority of RFCs are not about HTTP.

Some non-misleading ways to phrase this could be:
1. “The most normative are its RFCs (9113 and 7540)”
2. “The most normative is its specification”
3. “The most normative is RFC 9113”

> Regarding the definition of h2c, surely "HTTP/2 over TCP" is far more
> specific and meaningful than "a protocol that does not use TLS". FTP is a
> protocol that does not us TLS. Gopher is a protocol that does not use TLS.
> That feels like a meaningless definition.
Of course. That quote is from
https://www.rfc-editor.org/info/rfc9113/#name-starting-http-2-for-https-u and
in the context of HTTP.

> What are you suggesting that we change here?
Well, the ideal would be to remove that item, since h2c was removed years ago.
But “h2c is an HTTP/2 protocol that does not use TLS.” would be OK.

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


[Bug 70119] HTTP/2 guide: “its RFC 9113”

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70119

Philippe Cloutier <ch...@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|RESOLVED                    |VERIFIED

--- Comment #4 from Philippe Cloutier <ch...@gmail.com> ---
Thank you SO much Rich🙏, one more time

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


[Bug 70119] HTTP/2 guide: “its RFC 9113”

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70119

Rich Bowen <rb...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |NEEDINFO

--- Comment #1 from Rich Bowen <rb...@apache.org> ---
I don't understand the phrase "should precede something countable". One is
countable, so I presume you're saying something different than that. 9113 is
indeed its RFC - the RFC describing HTTP/2. So I'm not clear what distinction
you're making. Can you elaborate?

Regarding the definition of h2c, surely "HTTP/2 over TCP" is far more specific
and meaningful than "a protocol that does not use TLS". FTP is a protocol that
does not us TLS. Gopher is a protocol that does not use TLS. That feels like a
meaningless definition. What are you suggesting that we change here?

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


[Bug 70119] HTTP/2 guide: “its RFC 9113”

Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70119

Rich Bowen <rb...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|---                         |FIXED

--- Comment #3 from Rich Bowen <rb...@apache.org> ---
These phrases no longer occur after the rewrite/refresh of the /howto directory
and all content therein.

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org