[no subject]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[no subject]
idnits (2.08.03)
* Improved differentiation between ABNF and references
idnits (2.08.02)
New rev based on input from John Klensin:
* The note about information on normative references referred to
RFC 3967 -- added a reference to 4897, which updates it.
* Improved the extraction of referenced RFC number in references
Regards,
Henrik
On 2008-02-20 10:24 Henrik Levkowetz said the following:
> Hi John,
>
> Thanks for the feedback. More inline:
>
> On 2008-02-20 02:14 John C Klensin said the following:
>> Henrik,
>>
>> I just tried running draft-klensin-rfc2821bis-07.txt through the
>> online idnits checker and discovered several small bugs. I
>> don't think any of these are urgent, or even nearly-so, but
>> thought them worth reporting and getting into the queue.
>
> Yes, that's much appreciated.
>
>> An annotated extract from the checker output is attached.
>> Comments start and end in ###.
>>
>> best,
>> john
>
>
>
>> Checking references for intended status: Proposed Standard
>> ----------------------------------------------------------------------------
>>
>> (See RFC 3967 for information about using normative references to
>> lower-maturity documents in RFCs)
>>
>> ### Probably should mention RFC 4897 since both together are BCP 97 ###
>
> Right. Will be fixed in v2.08.02
>
>> -- Looks like a reference, but probably isn't:
>> 'Additional-Registered-Clauses' on line
>> 2773
>> '[Additional-Registered-Clauses]...'
>>
>> ### What it is is a piece of ABNF ###
>
> Ah. I have some extremely primitive code to detect whether I'm in ABNF;
> I'm going to use this to try to reduce this problem. A quick test now
> on the same document shows it working in this case, at least. Will have
> to see if the regression testing shows negative effects. If not, this
> will be fixed in v2.08.02.
>
>> == Unused Reference: '8' is defined on line 3764, but no explicit reference
>> was found in the text
>> '[8] Newman, C., "ESMTP and LMTP Transmission Types Registration",...'
>>
>> ### This actually is in the text, but it appears only in a comment in
>> the ABNF. ###
>
> Hmm. Not sure what's right thing to do here -- but the ABNF fix did
> unfortunately not eliminate this one. Should stuff in ABNF comments
> be ignored for this purpose, or not?
>
>> -- Possible downref: Non-RFC (?) normative reference: ref. '2'
>>
>> ** Obsolete normative reference: RFC 821 (ref. '7') (Obsoleted by
>> RFC 2821)
>>
>> ### But this is a reference to text found there that is still
>> relevant, so the reference is not precisely to obsolete text ###
>
> I looked at the text in the document. Relevant I'll grant you, but does
> that mean it's normative? For an informative reference, I'd emit the
> format you see below for 822, is maybe a bit more reasonable?
>
>> -- Possible downref: Normative reference to a draft: ref. '10' (No
>> intended status found in state file of draft-resnick-2822upd)
>>
>> -- Obsolete informational reference (is this intentional?): RFC 822 (ref.
>> '13') (Obsoleted by RFC 2822)
>>
>> -- Obsolete informational reference (is this intentional?): RFC 974 (ref.
>> '16') (Obsoleted by RFC 2821)
>>
>> -- Obsolete informational reference (is this intentional?): RFC 1869 (ref.
>> '22') (Obsoleted by RFC 2821)
>>
>> -- Duplicate reference: RFC822, mentioned in '28', was also mentioned in
>> '13'.
>>
>> ### This one and the next one are actually interesting, because
>> reference [28] is not a reference for RFC822. It is a reference
>> for RFC 2126, whose title is "MIXER (Mime Internet X.400 Enhanced
>> Relay): Mapping between X.400 and RFC 822/MIME". So there might
>> be a small parsing problem in the checker. ###
>
> Right. This needs looking at, and may not be a fix I can do in just a few
> minutes. Noted.
>
>> -- Obsolete informational reference (is this intentional?): RFC 822 (ref.
>> '28') (Obsoleted by RFC 2822)
>>
>>
>> Summary: 3 errors (**), 2 warnings (==), 8 comments (--).
>
>
> Thanks!
>
>
> Henrik
> _______________________________________________
> Tools-discuss mailing list
> Tools-discuss at ietf.org
> http://www.ietf.org/mailman/listinfo/tools-discuss
>
_______________________________________________
Tools-discuss mailing list
Tools-discuss at ietf.org
http://www.ietf.org/mailman/listinfo/tools-discuss
Note: Messages sent to this list are the opinions of the senders and do not imply endorsement by the IETF.