Re: [sca-c-cpp] NEW ISSUE: Correct C++ Terminology

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

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

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

Bryan Aupperle/Raleigh/IBM@IBMUS

10/03/2008 11:26 AM

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

Target: C++ Client and Implementation Specification

Description:  The current specification. has numerous occurrences
of "method"  which
is not correct C++ terminology. Most of these are in prose and can be easily
changed to either "member function" or "operation"
based on context (i.e. specific to C++ or referring to a service operation).
 However, we also have method
and callbackMethod child elements in interface.cpp and a method child element
in implementation.cpp (the method child elements both appeared in the 1.0
schema).

Proposal: 
1) Replace "method" in the prose with either "member function"
or "operation" as appropriate for the context..
2) Rename the method child elements to function (memberFunction seems cumbersome
here).  This is a significant change and needs to be noted in the
migration appendix.  We should allow an implementation to support
both method and function child elements. 
3) Rename the callbackMethod child element to callbadkFunction.  This
child element was not in the 1.0 schema so this is a less significant change.

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