Re: [sca-c-cpp] NEW ISSUE: C++ API detail

[Bryan Aupperle <aupperle@us.ibm.com>]

This issue has been assigned id CCPP-44
in the Jira system. 
See http://www.osoa.org/jira/browse/CCPP-44

Bryan Aupperle, Ph.D.
STSM, WebSphere Enterprise Platform Software Solution Architect
Master Inventor

Research Triangle Park,  NC 
+1 919-254-7508 (T/L 444-7508)
Internet Address: aupperle@us.ibm.com

Bryan Aupperle/Raleigh/IBM@IBMUS

08/19/2008 02:51 PM

To	sca-c-cpp@lists.oasis-open.org
cc
Subject	[sca-c-cpp] NEW ISSUE: C++ API detail

Target: C++ C&I specification CD-01 Rev 1 

Description: 

Section 7.2 and 7.3 of the C++ specification describes the Component Context
and Service Reference APIs. 

These APIs have several methods with various parameters and return values.
The descriptions of these methods are all very brief and do not adequately
describe preconditions, postconditions, nor adequately describe the parameter
values and return values for the methods. 

The lack of clarity and detail means that implementers and users of the
API cannot be sure what is expected from each method. 

Proposal: 

None at present. 

Bryan Aupperle, Ph.D.
STSM, WebSphere Enterprise Platform Software Solution Architect

Research Triangle Park,  NC 
+1 919-254-7508 (T/L 444-7508)
Internet Address: aupperle@us.ibm.com