Re: [Tools-discuss] FW: Idnits tool

[Henrik Levkowetz <henrik at levkowetz.com>]

Hi David,

on 2006-12-07 00:36 David Harrington said the following:
> Hi, 
> 
> Dbh> idnits tools complains about missing Security Considerations
> sections.
> dbh> draft-ietf-syslog-device-mib-11 seems to have a "Security
> Considerations"
> dbh> section.
> dbh> What exactly is the idnits tool looking for to make the
> dbh> determination of whether a document has a Security Considerations
> section?
> 
> Bill>It looks like it wants the section number to be left-justified.
> I'd
> Bill>recommend bringing this up on tools-discuss at ietf.org .

That's pretty much it.  Idnits removes the header and footer lines,
and finds the smallest indentation of the remaining lines.  This is
taken to be the indentation of top-level sections, and the security
considerations section is expected to be one.  In this case, the
top-level sections have zero indentation, while the security
considerations section has an indentation flush with the paragraph
text, which makes it indistinguishable from for instance a numbered
list item.

Yes, this isn't ideal, but I think it would be as much of a flaw
if a document without a security considerations section, but with
the words 'security considerations' listed in a numbered list, was
flagged as 'OK'.

I'm sorry -- I don't really have a better resolution for this.

After all, idnits is a only a tool - a human inspecting the document
will swiftly find that there is indeed a security considerations
section, and things are fine.


	Henrik


_______________________________________________
Tools-discuss mailing list
Tools-discuss at ietf.org
https://www1.ietf.org/mailman/listinfo/tools-discuss