Issue 18198: "this header is usually included" should be excluded (vsiplxx-ftf)
Source: Mentor Graphics Corporation (Mr. Brooks Moses, brooks_moses(at)mentor.com)
Nature: Revision
Severity: Minor
Summary: These sections contain phrases like, "Note: This header file is usually
included in other header files so direct inclusion is rarely necessary."


This is non-normative, and because "usually" means "some implementations
may not do this", it is not helpful to users in writing
standard-conformant code.  In fact, it encourages users to write
non-comforming code!  These should be removed.



Resolution: 
Revised Text: 
Actions taken:
October 23, 2012: received issue
Discussion: 

End of Annotations:=====
te: Tue, 23 Oct 2012 10:15:18 -0700
From: Brooks Moses <brooks_moses@mentor.com>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:10.0.2) Gecko/20120216 Thunderbird/10.0.2
To: <issues@omg.org>
Subject: VSIPL++ issue (#4 from me)
X-OriginalArrivalTime: 23 Oct 2012 17:15:19.0838 (UTC) FILETIME=[FA908BE0:01CDB141]


Name:            Brooks Moses
Employer:        Mentor Graphics
mailFrom:        brooks_moses@mentor.com
Terms_Agreement: I agree
Specification:   VSIPL++
Section:         4 [initfin], 6.3 [block.dense]
FormalNumber:    ptc/2012-07-27
Version:         1.2 - FTF Beta 1
Doc_Year:        2012
Doc_Month:       August
Doc_Day:         10
Page:            11, 28
Title:           VSIPL and VSIPL++ should define version macros
Nature:          Bug
Severity:        Minor
B1:              Report Issue


Description:


These sections contain phrases like, "Note: This header file is usually
included in other header files so direct inclusion is rarely necessary."


This is non-normative, and because "usually" means "some implementations
may not do this", it is not helpful to users in writing
standard-conformant code.  In fact, it encourages users to write
non-comforming code!  These should be removed.

- Brooks