Changeset 14837 in project


Ignore:
Timestamp:
05/30/09 18:17:43 (10 years ago)
Author:
sjamaan
Message:

Update docs to match the changed header parser interface

File:
1 edited

Legend:

Unmodified
Added
Removed
  • wiki/eggref/4/intarweb

    r14586 r14837  
    361361<tr>
    362362<td>{{if-match}}</td>
    363 <td>Entity-tags (pair, weak/strong symbol and unique entity identifier symbol) which must match.</td>
     363<td>Either {{'*}} (a wildcard symbol) or a list of entity-tags (pair, weak/strong symbol and unique entity identifier symbol).</td>
    364364<td>{{((strong . foo123) (strong . bar123))}}</td>
    365365</tr>
     
    371371<tr>
    372372<td>{{if-none-match}}</td>
    373 <td>Entity tags (pair, weak/strong symbol and unique entity identifier symbol) which must not match.</td>
     373<td>Either {{'*}} (a wildcard symbol) or a list of entity-tags (pair, weak/strong symbol and unique entity identifier symbol).</td>
    374374<td>{{((strong . foo123) (strong . bar123))}}</td>
    375375</tr>
     
    504504
    505505These (un)parsers are indexed with as key the header name (a symbol)
    506 and the value being a procedure which accepts three values: the name
    507 of the header (symbol), the contents of the header (a string, without
    508 the leading header name and colon) and the preceding headers. It
    509 should merge the new header with the preceding headers and return the
    510 resulting headers.
    511 
    512 Header parsers are supposed to call these procedures to add headers:
     506and the value being a procedure.
     507
     508A header parser accepts the contents of the header (a string, without
     509the leading header name and colon) and returns a ''list of vectors''
     510which represents the values of the header.  For headers that are
     511supposed to only have a single value, the last value in the list will
     512be stored as the value (as determined by {{single-headers}}).
     513
     514A header unparser accepts two arguments: the name of the header (a
     515symbol) and the header's contents (a vector).  It should return a
     516string which represents the header contents (without the header name).
     517
     518The parser driver will call {{update-header-contents!}} with the
     519parser's result.
    513520
    514521* <procedure>(replace-header-contents NAME CONTENTS HEADERS) => HEADERS</procedure>
Note: See TracChangeset for help on using the changeset viewer.