Re: Some consistency in IDL please

Jürgen Schmidt <[email protected]>
Newsgroups gmane.comp.openoffice.devel.api
Organization Oracle
Message-ID <[email protected]>
Hi,

i have cleaned up the IDLs on the dev300 codeline.

The @since tags were indeed used different all over in our IDL files. I
have unified the usage based on the following:

- use @since OOo <major>.<minor>[.<micro>]
<micro> is used only if > 0

Examples:
@since OOo 2.0
@since OOo 2.3
@since OOo 2.3.1
@since OOo 3.0
@since OOo 3.3

Things like
- @since OOo 2.0.0 got replaced with @since OOo 2.0
- @since OOo 2.3.0 got replaced with @since OOo 2.3
- @since OpenOffice.org 2.0.0 got replaced with @since OOo 2.0

Please take care of this in the future and use the new defined rule

@since OOo <major>.<minor>[.<micro>], <micro> only if > 0

Juergen


On 10/29/10 1:44 PM, Jürgen Schmidt wrote:
> On 10/29/10 1:21 PM, Stephan Bergmann wrote:
>> On 10/29/10 12:17, Bernard Marcelly wrote:
>>> For the latest version 3.3.0 I found these variants, on various IDLs:
>>>
>>> @since OpenOffice.org 3.3
>>> @since OOo 3.3
>>> @since OOo 3.3.0
>>> @since OOo3.3
>>> @since OpenOffice.org 3.3
>>>
>>> Please, API developers, could you stick to one rule ? :-)
>>
>> <http://wiki.services.openoffice.org/wiki/UNO_@since_Tags> documents
>> which rule to stick to.
> thanks for the pointer.
> 
> We have both versions for minors, e.g. 3.1 and 3.1.0. I think we should
> unify it to the short version 3.1. It's simply nicer and shorter. But we
> should always provide major and minor because 3.0 looks better than 3.
> 
> I will cleanup the IDLs
> 
> Juergen
> 
>>
>> -Stephan
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: [email protected]
>> For additional commands, e-mail: [email protected]
>>
>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.