* WGs marked with an * asterisk has had at least one new draft made available during the last 5 days

Ticket #372 (closed editorial: incorporated)

Opened 2 years ago

Last modified 2 years ago

refactor conditional header field descriptions

Reported by: julian.reschke@gmx.de Owned by:
Priority: normal Milestone: 20
Component: p4-conditional Severity: In WG Last Call
Keywords: Cc:
Origin:

Description

The current definitions for If-Match and If-None-Match could be simplified by stating exactly once what the expressed condition is, and then just refer to the outcome of this text in further discussions.

Such as

"The If-Match condition is met if and only if any of the entity-tags listed in the field value match (as per Section 2.3.2) the entity-tag of the selected representation for the target resource, or if "*" is given and any current representation exists for the target resource."

Then the following text could be simplified from:

"If none of the entity tags match, or if "*" is given and no current entity exists, the server MUST NOT perform the requested method, and MUST return a 412 (Precondition Failed) response. This behavior is most useful when the client wants to prevent an updating method, such as PUT, from modifying a resource that has changed since the client last retrieved it."

to

"If the condition is met, the server MUST NOT perform the requested method, and MUST return a 412 (Precondition Failed) response. This behavior is most useful when the client wants to prevent an updating method, such as PUT, from modifying a resource that has changed since the client last retrieved it."

(The effect for If-None-Match is bigger because the description is slightly more complex)

Attachments

372.diff (5.1 KB) - added by julian.reschke@gmx.de 2 years ago.
Proposed patch
372.2.diff (5.0 KB) - added by julian.reschke@gmx.de 2 years ago.
Proposed patch

Change History

Changed 2 years ago by julian.reschke@gmx.de

Proposed patch

Changed 2 years ago by julian.reschke@gmx.de

Proposed patch

comment:1 Changed 2 years ago by julian.reschke@gmx.de

From [1761]:

Refactor If-*Match header fields to separately define the condition (see #372)

comment:2 Changed 2 years ago by julian.reschke@gmx.de

  • Status changed from new to closed
  • Resolution set to incorporated
  • Milestone changed from unassigned to 20
Note: See TracTickets for help on using tickets.