APIs will confuse user

[James Jose <ja...@in.ibm.com>]

Hi, 
 
  void Call::setSOAPMethodAttribute(const AxisChar *pLocalname, const 
AxisChar *pPrefix, 
                                  const AxisChar *pUri, const AxisChar 
*pValue)

  In this API if we pass pPrefix, pUri will be discarded and an attribute 
is created with   prefix  'pPrefix'. If pPrefix is "" then it will create 
a namespace declaration and use the   corresponding prefix in the 
attribute creation. But on looking into this API, user will get   a 
feeling that this API will create a namespace declarion with prefix 
'pPrefix' and URi 'pUri'.  But it won't.

  Same case for IAttribute* createAttribute(const AxisChar* localname, 
        const AxisChar* prefix, const AxisChar* uri, const AxisChar* 
value) in IHeaderBlock

  So such APIs should create namespace declaration or such information 
should be documented.




Regards
James
--------------------------------------------------
James Jose
Messaging Clients Team, WMQDDC
IBM Software Labs, India
Direct: 91-80- 25094331  Ext :2331
E-mail: jamejose@in.ibm.com