[Accessibility-ia2] changing IA2 parameter names

Pete Brunet brunet at us.ibm.com
Tue Feb 12 11:51:45 PST 2008


I am working on the commentary in the IA2 IDL.  I'd like to change some 
parameter names, but only if there will be zero impact on any currently 
deployed code.  For example, in IA2::relations at 
    
http://accessibility.freestandards.org/a11yspecs/ia2/docs/html/interface_i_accessible2.html#7ae0ef43776506caaa33e4191687ed87 

the second parameter should be plural. 

Another case is that the input array size parameter is in the methods by 
mistake and besides documenting that the parameter will be ignored I could 
rename it.  For example on the above method the first parameter would be 
renamed from maxRelations to maxRelations-UNUSED.

BTW, The 8 methods that return arrays and that have the unused max input 
parameter are:

IA2
relations ([in] long maxRelations,[out, size_is(maxRelations), length_
is(*nRelations)] IAccessibleRelation **relation,[out, retval] long 
*nRelations)
extendedStates ([in] long maxExtendedStates,[out, size_is(, 
maxExtendedStates), length_is(,*nExtendedStates)] BSTR 
**extendedStates,[out, retval] long *nExtendedStates)
localizedExtendedStates ([in] long maxLocalizedExtendedStates,[out, 
size_is(, maxLocalizedExtendedStates), 
length_is(,*nLocalizedExtendedStates)] BSTR 
**localizedExtendedStates,[out, retval] long *nLocalizedExtendedStates)

IAAction
keyBinding ([in] long actionIndex,[in] long nMaxBinding,[out, size_is(, 
nMaxBinding), length_is(,*nBinding)] BSTR **keyBinding,[out, retval] long 
*nBinding)

IARelation
targets ([in] long maxTargets,[out, size_is(maxTargets), len
gth_is(*nTargets)] IUnknown **target,[out, retval] long *nTargets)

IATable
selectedChildren ([in] long maxChildren,[out, size_is(, maxChildren), 
length_is(,*nChildren)] long **children,[out, retval] long *nChildren)
selectedColumns ([in] long maxColumns,[out, size_is(, maxColumns), 
length_is(,*nColumns)] long **columns,[out, retval] long *nColumns)
selectedRows ([in] long maxRows,[out, size_is(, maxRows), 
length_is(,*nRows)] long **rows,[out, retval] long *nRows)

Pete Brunet
                                                                          
IBM Accessibility Architecture and Development
11501 Burnet Road, MS 9022E004, Austin, TX 78758
Voice: (512) 838-4594, Cell: (512) 689-4155
Ionosphere: WS4G
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.linux-foundation.org/pipermail/accessibility-ia2/attachments/20080212/fa0dd113/attachment.htm 


More information about the Accessibility-ia2 mailing list