Examples for ETag matching

[mnot@…]

People seem to be confused about the weak matching function; we should have examples to illustrate it.

[mnot@…]

+--------+--------+-------------------+-----------------+
| ETag 1 | ETag 2 | Strong Comparison | Weak Comparison |
+--------+--------+-------------------+-----------------+
| W/"1"  | W/"1"  | no match          | match           |
|        |        |                   |                 |
| W/"1"  | W/"2"  | no match          | no match        |
|        |        |                   |                 |
| W/"1"  | "1"    | no match          | match           |
|        |        |                   |                 |
| "1"    | "1"    | match             | match           |
+--------+--------+-------------------+-----------------+

[julian.reschke@…]

Proposal:

1) Replace

" * The strong comparison function: in order to be considered equal, both validators MUST be identical in every way, and both MUST NOT be weak.

• The weak comparison function: in order to be considered equal, both validators MUST be identical in every way, but either or both of them MAY be tagged as "weak" without affecting the result."

and

" * The strong comparison function: in order to be considered equal, both opaque-tags MUST be identical character-by-character, and both MUST NOT be weak.

• The weak comparison function: in order to be considered equal, both opaque-tags MUST be identical character-by-character."

This uses "opaque-token" instead of "validator" in the definition of the matching functions.

2) Add the table below.

[julian.reschke@…]

Proposal:

1) Replace

" * The strong comparison function: in order to be considered equal, both validators MUST be identical in every way, and both MUST NOT be weak.

• The weak comparison function: in order to be considered equal, both validators MUST be identical in every way, but either or both of them MAY be tagged as "weak" without affecting the result."

by

" * The strong comparison function: in order to be considered equal, both opaque-tags MUST be identical character-by-character, and both MUST NOT be weak.

• The weak comparison function: in order to be considered equal, both opaque-tags MUST be identical character-by-character."

This uses "opaque-token" instead of "validator" in the definition of the matching functions.

2) Add the table below.

[julian.reschke@…]

proposed change for part 3.

[julian.reschke@…]

Fixed in [298]:

Resolve #71: Clarify matching functions and add examples (closes #71).

[julian.reschke@…]

From [610]:

re-add text about how to do the weak match (while resolving #71 it got a bit terse) (related to #71)