Re: comments on java bindings update, draft-ietf-kitten-rfc2853bis-02

On Tuesday, November 07, 2006 06:56:22 PM -0800 Ken Raeburn 
<raeburn@MIT.EDU> wrote:

> Jeff was complaining because not enough people had reviewed the java
> bindings, so I took a look.  Not that I'm any great expert on Java,  but
> I do okay with English and sometimes even with GSSAPI...
>
> The abstract says in part:
>
>       This document
>     updates the Java bindings for the GSS-API that are specified in
>     "Generic Security Service API version 2 : Java Bindings" (RFC2853).
>     This document obsoletes RFC2853 by making specific and incremental
>     clarifications and corrections to it in response to  identification of
>     transcription errors and implementation experience.

A well-written abstract would stop right there.  This...

> The note-worthy
>     changes are in sections 4.12.1, 6.2.2, 6.3.2, and 6.8.1 of RFC2853,
>     which are replaced by the sections 5.12.1, 7.2.2, 7.3.2, and  7.8.1 of
>     this document, where numerical constants were either added or
>     modified.

... belongs in the introduction, but not in the abstract.

> * inserted the usual "conventions used in this document" section,  before
> the introduction (resulting in a renumbering of sections  through the
> whole document), even though the key words described  there are not
> actually used in the document; I haven't checked the  rules, but I would
> hope we can omit it in that case

There is no need for an RFC2119 reference unless requirements keywords from 
that document are actually used.

-- Jeff

_______________________________________________
Kitten mailing list
Kitten@lists.ietf.org
https://www1.ietf.org/mailman/listinfo/kitten