ietf-nntp Alternative HDR parameter proposal

[Ken Murchison]

Here is some text for my alternate HDR proposal.  I _believe_ sections
10.6.1 are fine as-is.


10.6 The HDR extension

   This extension provides two new commands: HDR and LIST HEADERS.
   The label for this extension is HDR.  The HDR label has one OPTIONAL
   argument "ALL" which indicates that the HDR command may be used to
   retrieve any header from an article or return any metadata about an
   article.



10.6.2 LIST HEADERS

10.6.2.1 Usage

   Syntax
      LIST HEADERS

   Responses
      215   Header list follows (multiline)
      503   Header list unavailable


10.6.2.2 Description

   The LIST HEADERS command returns a list of headers and metadata items
   that may be retrieved by the HDR command for a newly-received article
   (the headers and metadata items available for articles may change
over
   time).

   The list of headers and metadata items is returned as a multi-line
   response following the 215 response code.  Each header or metadata
item
   is listed on a separate line, and is case-insensitive.  The header
and
   metadata item names are listed in the same form as they would be used
   as parameters to the HDR command.

   A server MUST NOT try to list header and metadata items when it
advertises
   the HDR ALL capability.  In this case, a 503 response MUST be
returned.

   If a server also supports the OVER extension, it SHOULD try to
support
   at least those headers and metadata items listed in the LIST
OVERVIEW.FMT
   response.

10.6.2.3 Examples

   Example of LIST HEADERS output corresponding to the mandatory OVER
fields:

      [C] LIST EXTENSIONS
      [S] 202 Extensions supported:
      [S] HDR
      [S] OVER
      [S] .
      [C] LIST HEADERS
      [S] 215 Header list follows:
      [S] Subject
      [S] From
      [S] Date
      [S] Message-ID
      [S] References
      [S] :bytes
      [S] :lines
      [S] .

   Example of LIST HEADERS output corresponding to a restricted set of
headers:

      [C] LIST EXTENSIONS
      [S] 202 Extensions supported:
      [S] HDR
      [S] .
      [C] LIST HEADERS
      [S] 215 Header list follows:
      [S] Subject
      [S] Date
      [S] Message-ID
      [S] References
      [S] .

   Example of LIST HEADERS returning an error:

      [C] LIST EXTENSIONS
      [S] 202 Extensions supported:
      [S] HDR ALL
      [S] .
      [C] LIST HEADERS
      [S] 503 Header list unavailable


-- 
Kenneth Murchison     Oceana Matrix Ltd.
Software Engineer     21 Princeton Place
716-662-8973 x26      Orchard Park, NY 14127
--PGP Public Key--    http://www.oceana.com/~ken/ksm.pgp