Subject: [quicwg/base-drafts] 972e7e: Massive batch of probably-editorial nits

From: Martin Thomson <[email-masked]>
Date: Tue, 14 Jul 2020 15:47:44 -0700

Branch: refs/heads/cherry-pick-ekr-edit
  Home:   https://github.com/quicwg/base-drafts
  Commit: 972e7e5dac3f5ba1c41f716bb5180e5d743fce2c
      https://github.com/quicwg/base-drafts/commit/972e7e5dac3f5ba1c41f716bb5180e5d743fce2c
  Author: Mike Bishop <[email-masked]>
  Date:   2020-06-30 (Tue, 30 Jun 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Massive batch of probably-editorial nits

  Commit: e3094fab788fe42ccf4ab6ee4cf023d807da6aee
      https://github.com/quicwg/base-drafts/commit/e3094fab788fe42ccf4ab6ee4cf023d807da6aee
  Author: Mike Bishop <[email-masked]>
  Date:   2020-06-30 (Tue, 30 Jun 2020)

  Changed paths:
    M draft-ietf-quic-http.md
    M draft-ietf-quic-invariants.md
    M draft-ietf-quic-recovery.md
    M draft-ietf-quic-tls.md
    M draft-ietf-quic-transport.md
    M protection-samples.js

  Log Message:
  -----------
  Merge remote-tracking branch 'origin/master' into transport/mbishop_wglc

  Commit: f7b6aab88c9b98000bd91ae3ed817188ffb21fe9
      https://github.com/quicwg/base-drafts/commit/f7b6aab88c9b98000bd91ae3ed817188ffb21fe9
  Author: Mike Bishop <[email-masked]>
  Date:   2020-06-30 (Tue, 30 Jun 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Overzealous

  Commit: f9fdab10ce23e66de11ac3447b1040cef39fe24c
      https://github.com/quicwg/base-drafts/commit/f9fdab10ce23e66de11ac3447b1040cef39fe24c
  Author: Mike Bishop <[email-masked]>
  Date:   2020-07-02 (Thu, 02 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  For for for

  Commit: 4a967aa11e096c98f927bd5a9eb29dd6c170edc0
      https://github.com/quicwg/base-drafts/commit/4a967aa11e096c98f927bd5a9eb29dd6c170edc0
  Author: Mike Bishop <[email-masked]>
  Date:   2020-07-02 (Thu, 02 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Clarify STOP_SENDING in "Data Sent"

  Commit: 40f96bb96344c97df9878768ec09a50a6b4e7f86
      https://github.com/quicwg/base-drafts/commit/40f96bb96344c97df9878768ec09a50a6b4e7f86
  Author: Mike Bishop <[email-masked]>
  Date:   2020-07-02 (Thu, 02 Jul 2020)

  Changed paths:
    M draft-ietf-quic-tls.md

  Log Message:
  -----------
  TLS review

  Commit: 2ae16098ac4a98c56ad7d6bc5c5b0cca521b660f
      https://github.com/quicwg/base-drafts/commit/2ae16098ac4a98c56ad7d6bc5c5b0cca521b660f
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-06 (Mon, 06 Jul 2020)

  Changed paths:
    M draft-ietf-quic-tls.md

  Log Message:
  -----------
  Reword paragraph on HelloRetryRequest

This was a little clumsy.

  Commit: b194f64d522074b3ee677bf5325563cdf3bfa124
      https://github.com/quicwg/base-drafts/commit/b194f64d522074b3ee677bf5325563cdf3bfa124
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-06 (Mon, 06 Jul 2020)

  Changed paths:
    M draft-ietf-quic-tls.md

  Log Message:
  -----------
  Leaner is good

  Commit: 14bff7c8f65a3911533d66fecb70f9db6f64ceba
      https://github.com/quicwg/base-drafts/commit/14bff7c8f65a3911533d66fecb70f9db6f64ceba
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-06 (Mon, 06 Jul 2020)

  Changed paths:
    M draft-ietf-quic-invariants.md

  Log Message:
  -----------
  Fix description of Version Negotiation

As Magnus noted, the description of the first byte is missing, and I
also noticed that the Supported Version field was described as following
Version, which is wrong.

  Commit: 6e638be2da8793e2f410fb5584b096f38914f904
      https://github.com/quicwg/base-drafts/commit/6e638be2da8793e2f410fb5584b096f38914f904
  Author: Mike Bishop <[email-masked]>
  Date:   2020-07-07 (Tue, 07 Jul 2020)

  Changed paths:
    M draft-ietf-quic-tls.md

  Log Message:
  -----------
  Update draft-ietf-quic-tls.md

Co-authored-by: Martin Thomson <[email-masked]>

  Commit: 39e6b42ec95308fec64a01c22716c2f821bcf898
      https://github.com/quicwg/base-drafts/commit/39e6b42ec95308fec64a01c22716c2f821bcf898
  Author: Mike Bishop <[email-masked]>
  Date:   2020-07-07 (Tue, 07 Jul 2020)

  Changed paths:
    M draft-ietf-quic-tls.md

  Log Message:
  -----------
  Apply suggestions from code review

Co-authored-by: Martin Thomson <[email-masked]>

  Commit: 9d55480335f0988bc4ca0ba4a793e50cb4011b19
      https://github.com/quicwg/base-drafts/commit/9d55480335f0988bc4ca0ba4a793e50cb4011b19
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-08 (Wed, 08 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Split minimum idle timeout period

The text as written implied that the actual timeout period was
calculated using:

```
min(max_idle_timeout[client],
    max_idle_timeout[server],
    3 * PTO)
```
This is silly, as 3PTO is usually smaller than the other two values, and
connections would time out too fast.

Splitting the text regarding the 3PTO backstop makes this clearer.

  Commit: d44f3c87218775820808aa5c6357298d7b0753ed
      https://github.com/quicwg/base-drafts/commit/d44f3c87218775820808aa5c6357298d7b0753ed
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-08 (Wed, 08 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Remove the justification (too hard)

  Commit: 1126251530f1f4d7fa9ae7fb843bdfe95bdf7611
      https://github.com/quicwg/base-drafts/commit/1126251530f1f4d7fa9ae7fb843bdfe95bdf7611
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-08 (Wed, 08 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Which DCID determines Initial keys

This is better defined elsewhere, but it doesn't hurt to repeat it.

Closes #3840.

  Commit: c0d8a453b56a7f51ea56beae22d12073dd227b9b
      https://github.com/quicwg/base-drafts/commit/c0d8a453b56a7f51ea56beae22d12073dd227b9b
  Author: Mike Bishop <[email-masked]>
  Date:   2020-07-09 (Thu, 09 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Incorporating feedback

  Commit: af4f6bc3959128e04f28ae07695f58f62caaaabc
      https://github.com/quicwg/base-drafts/commit/af4f6bc3959128e04f28ae07695f58f62caaaabc
  Author: Mike Bishop <[email-masked]>
  Date:   2020-07-09 (Thu, 09 Jul 2020)

  Changed paths:
    M draft-ietf-quic-tls.md
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge remote-tracking branch 'origin/master' into transport/mbishop_wglc

  Commit: 41ede48ef5a7a9d73998645492c09e4f154bfbdd
      https://github.com/quicwg/base-drafts/commit/41ede48ef5a7a9d73998645492c09e4f154bfbdd
  Author: ianswett <[email-masked]>
  Date:   2020-07-13 (Mon, 13 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Gorry's suggestion on asymmetric links

Fixes #3885

  Commit: 8c4fe3d99fb185ac0ced223c4b9405fde94db45d
      https://github.com/quicwg/base-drafts/commit/8c4fe3d99fb185ac0ced223c4b9405fde94db45d
  Author: Mike Bishop <[email-masked]>
  Date:   2020-07-13 (Mon, 13 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Apply suggestions from code review

Co-authored-by: Martin Thomson <[email-masked]>

  Commit: e1dd809c59ded51e59d68e38d659f602f7aee526
      https://github.com/quicwg/base-drafts/commit/e1dd809c59ded51e59d68e38d659f602f7aee526
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-invariants.md

  Log Message:
  -----------
  Merge pull request #3829 from quicwg/invariant-unused

Fix description of Version Negotiation

  Commit: 1da964a57d65d8100e519de56bdd446efdf3c548
      https://github.com/quicwg/base-drafts/commit/1da964a57d65d8100e519de56bdd446efdf3c548
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-http.md
    M draft-ietf-quic-invariants.md
    M draft-ietf-quic-qpack.md
    M draft-ietf-quic-recovery.md
    M draft-ietf-quic-tls.md
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge branch 'master' into tls/mbishop_wglc

  Commit: 5c626a3f37e622e2127d468ab80a15d112e363d6
      https://github.com/quicwg/base-drafts/commit/5c626a3f37e622e2127d468ab80a15d112e363d6
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-tls.md

  Log Message:
  -----------
  Merge pull request #3818 from quicwg/tls/mbishop_wglc

Editorial suggestions on TLS

  Commit: 5c4da195e0df99ec10403f204be4ac319198039a
      https://github.com/quicwg/base-drafts/commit/5c4da195e0df99ec10403f204be4ac319198039a
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge pull request #3847 from quicwg/idle-3pto

Split minimum idle timeout period

  Commit: 352d9512f3924ecbefe76245dea16cd9a413d845
      https://github.com/quicwg/base-drafts/commit/352d9512f3924ecbefe76245dea16cd9a413d845
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-tls.md

  Log Message:
  -----------
  Merge pull request #3826 from quicwg/reword-hrr

Reword paragraph on HelloRetryRequest

  Commit: 8b60a676470b4eb51beb3cef6c5c73606f1f90f3
      https://github.com/quicwg/base-drafts/commit/8b60a676470b4eb51beb3cef6c5c73606f1f90f3
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-http.md
    M draft-ietf-quic-invariants.md
    M draft-ietf-quic-qpack.md
    M draft-ietf-quic-recovery.md
    M draft-ietf-quic-tls.md
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge branch 'master' into transport/mbishop_wglc

  Commit: 4bbc69fa482ab5811a2b094413ab66e6220c8162
      https://github.com/quicwg/base-drafts/commit/4bbc69fa482ab5811a2b094413ab66e6220c8162
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Fix grammar, wrap

  Commit: f2e30d93b472ab3059e24c3ea91d48607e39f772
      https://github.com/quicwg/base-drafts/commit/f2e30d93b472ab3059e24c3ea91d48607e39f772
  Author: Mike Bishop <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Could swear I fixed this, which probably means a conflict later

  Commit: 5f4e727eb5037be27677a072747cd13fe7c73bd8
      https://github.com/quicwg/base-drafts/commit/5f4e727eb5037be27677a072747cd13fe7c73bd8
  Author: ianswett <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Update draft-ietf-quic-transport.md

Co-authored-by: Martin Thomson <[email-masked]>

  Commit: 78337c51f572dad10d6e764dd4ef6656f91960c0
      https://github.com/quicwg/base-drafts/commit/78337c51f572dad10d6e764dd4ef6656f91960c0
  Author: ianswett <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge pull request #3896 from quicwg/ianswett-asymmetric-links

Gorry's suggestion on asymmetric links

  Commit: 3800a27f7e3f0faf6765fc3ee1a0621c977458a0
      https://github.com/quicwg/base-drafts/commit/3800a27f7e3f0faf6765fc3ee1a0621c977458a0
  Author: ianswett <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Use kGranularity in persistent congestion

This aligns the calculation with the PTO calculation, which is what persistent congestion is based off.

Fixes #3899

  Commit: 7a04b24af70c4abd6c62995beac78608b77e3a82
      https://github.com/quicwg/base-drafts/commit/7a04b24af70c4abd6c62995beac78608b77e3a82
  Author: Bence Béky <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-http.md

  Log Message:
  -----------
  [HTTP/3] [editorial] Fix SETTINGS_MAX_FIELD_SECTION_SIZE usage. (#3903)

Replace SETTINGS_MAX_HEADER_LIST_SIZE with
SETTINGS_MAX_FIELD_SECTION_SIZE in one last place.

Add comment to HTTP/2 identifier mapping section about rename.

Co-authored-by: Bence Béky <[email-masked]>

  Commit: 8a47f355fd9060f875c226815a9e3b0683da79cc
      https://github.com/quicwg/base-drafts/commit/8a47f355fd9060f875c226815a9e3b0683da79cc
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-15 (Wed, 15 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge pull request #3862 from quicwg/the-first-cid

Which DCID determines Initial keys

  Commit: 5928f1ad84babf27c469026d934d8177ddeb0088
      https://github.com/quicwg/base-drafts/commit/5928f1ad84babf27c469026d934d8177ddeb0088
  Author: Jana Iyengar <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Merge pull request #3905 from quicwg/ianswett-persistent-congestion-granularity

Use kGranularity in persistent congestion

  Commit: 70d1e158a764b92208b5510ec8db2ed394ebaca3
      https://github.com/quicwg/base-drafts/commit/70d1e158a764b92208b5510ec8db2ed394ebaca3
  Author: Bence Béky <[email-masked]>
  Date:   2020-07-14 (Tue, 14 Jul 2020)

  Changed paths:
    M draft-ietf-quic-http.md

  Log Message:
  -----------
  [HTTP/3] [editorial] Minor fix in GOAWAY wording. (#3906)

* [HTTP/3] [editorial] Minor fix in GOAWAY wording.

1. Move "A client that is unable to retry requests [...]" sentence from
the beginning of an entirely unrelated paragraph to somewhere more
appropriate.

2. Change Push ID requirement on subsequent GOAWAY frames.  This was
presumably an oversight, because "An endpoint MAY send multiple GOAWAY
frames indicating different identifiers [...]" paragraph above is pretty
clear and covers both directions already.

* Update draft-ietf-quic-http.md

Co-authored-by: Bence Béky <[email-masked]>
Co-authored-by: Mike Bishop <[email-masked]>

  Commit: fdd42d123b3a3009bb45749f1b55ec7b83b2d3f5
      https://github.com/quicwg/base-drafts/commit/fdd42d123b3a3009bb45749f1b55ec7b83b2d3f5
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-15 (Wed, 15 Jul 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge pull request #3805 from quicwg/transport/mbishop_wglc

Massive batch of probably-editorial nits

  Commit: fc972928fb64f7cd15057a3dc634940e5a40553f
      https://github.com/quicwg/base-drafts/commit/fc972928fb64f7cd15057a3dc634940e5a40553f
  Author: Martin Thomson <[email-masked]>
  Date:   2020-07-15 (Wed, 15 Jul 2020)

  Changed paths:
    M draft-ietf-quic-http.md
    M draft-ietf-quic-invariants.md
    M draft-ietf-quic-recovery.md
    M draft-ietf-quic-tls.md
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge branch 'master' into cherry-pick-ekr-edit

Compare: https://github.com/quicwg/base-drafts/compare/68bf99ffa593...fc972928fb64