ietf-nntp Section 7 minor points

[Clive D.W. Feather]

Two minor points.

Firstly, the notation used in the examples for starting and ending a
connection are inconsistent with each other; the former also looks like
it's a message sent over the connection. Can I suggest that instead we use
indented bracket text, thus:

  7.1.1 Initial Connection Example
  
  Example of a normal connection from an authorized client  
  
!         [Initial TCP connection completed]
          [S] 200 NNTP Service Ready, posting permitted 
  
  Client can send commands at this point. In this example, the
  client jumps directly to the conclusion step (See section 10).

          [C] QUIT
          [S] 205 NNTP Service exits normally
!         [Server closes connection]
  
  Example of a normal connection from an unauthorized client
  
!         [Initial TCP connection completed]
          [S] 502 NNTP Service Unavailable
!         [Server closes connection]
 
  Example of a normal connection from an authorized client that
  is not permitted to post
  
!         [Initial TCP connection completed]
          [S] 201 NNTP Service Ready, posting prohibited
  
  Client can send commands at this point. In this example, the
  client jumps directly to the conclusion step (See section 10).

          [C] QUIT
          [S] 205 NNTP Service exits normally
!         [Server closes connection]
  
  Example of a connection from any client where the server is
  unable to provide service
  
!         [Initial TCP connection completed]
          [C] Initial TCP connection completed
          [S] 400 NNTP Service temporarily unavailable
!         [Server closes connection]
  
  7.1.2 MODE READER


Secondly, the current numbering is:

  7. The GREETING Step
  7.1 Initial Connection
  7.1.1 Initial Connection Example
  7.1.2 MODE READER
  7.1.2.1 Responses
  7.1.2.2 MODE READER Examples

Can I suggest that MODE READER isn't really a subsection of the initial
connection, and a better numbering would be:

  7. The GREETING Step
  7.1 Initial Connection
  7.1.1 Initial Connection Example
  7.2 MODE READER
  7.2.1 Responses
  7.2.2 MODE READER Examples

[I want to talk about MODE READER, but I'll address that separately.]

-- 
Clive D.W. Feather  | Work:  <clive at demon.net>   | Tel:  +44 20 8371 1138
Internet Expert     | Home:  <clive at davros.org>  | Fax:  +44 20 8371 1037
Demon Internet      | WWW: http://www.davros.org | DFax: +44 20 8371 4037
Thus plc            |                            | Mobile: +44 7973 377646