Re: [api-dev] Some consistency in IDL please

2010-11-03 Thread Jürgen Schmidt
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/u...@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: dev-unsubscr...@api.openoffice.org
 For additional commands, e-mail: dev-h...@api.openoffice.org

 


-
To unsubscribe, e-mail: dev-unsubscr...@api.openoffice.org
For additional commands, e-mail: dev-h...@api.openoffice.org



Re: [api-dev] Some consistency in IDL please

2010-11-03 Thread Frank Schönheit
Hi Jürgen,

 Please take care of this in the future and use the new defined rule
 
 @since OOo major.minor[.micro], micro only if  0

(I doubt many people will read this, buried here in this thread :) )

What about autodoc enforcing this? Since autodoc is ran in the odk
module, not following the rule would break the build ...

Ciao
Frank

-- 
ORACLE
Frank Schönheit | Software Engineer | frank.schoenh...@oracle.com
Oracle Office Productivity: http://www.oracle.com/office

-
To unsubscribe, e-mail: dev-unsubscr...@api.openoffice.org
For additional commands, e-mail: dev-h...@api.openoffice.org



Re: [api-dev] Some consistency in IDL please

2010-11-03 Thread Stephan Bergmann

On 11/03/10 08:30, Jürgen Schmidt wrote:

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

@since OOomajor.minor[.micro],micro  only if  0


care to update 
http://wiki.services.openoffice.org/wiki/u...@since_tags accordingly?


-Stephan

-
To unsubscribe, e-mail: dev-unsubscr...@api.openoffice.org
For additional commands, e-mail: dev-h...@api.openoffice.org



Re: [api-dev] Some consistency in IDL please

2010-11-03 Thread Jürgen Schmidt
On 11/3/10 9:04 AM, Stephan Bergmann wrote:
 On 11/03/10 08:30, Jürgen Schmidt wrote:
 Please take care of this in the future and use the new defined rule

 @since OOomajor.minor[.micro],micro  only if  0
 
 care to update
 http://wiki.services.openoffice.org/wiki/u...@since_tags accordingly?
i will do that and i will add it to the IDL documentation guideline
http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/AppendixB/IDL_Documentation_Guidelines


Juergen

 
 -Stephan
 
 -
 To unsubscribe, e-mail: dev-unsubscr...@api.openoffice.org
 For additional commands, e-mail: dev-h...@api.openoffice.org
 


-
To unsubscribe, e-mail: dev-unsubscr...@api.openoffice.org
For additional commands, e-mail: dev-h...@api.openoffice.org



Re: [api-dev] Some consistency in IDL please

2010-11-03 Thread Frank Schönheit
 What about autodoc enforcing this? Since autodoc is ran in the odk
 module, not following the rule would break the build ...
 could be a next step ;-)

http://www.openoffice.org/issues/show_bug.cgi?id=115368

Ciao
Frank

-- 
ORACLE
Frank Schönheit | Software Engineer | frank.schoenh...@oracle.com
Oracle Office Productivity: http://www.oracle.com/office

-
To unsubscribe, e-mail: dev-unsubscr...@api.openoffice.org
For additional commands, e-mail: dev-h...@api.openoffice.org



Re: [api-dev] Some consistency in IDL please

2010-11-03 Thread Stephan Bergmann

On 11/03/10 09:22, Jürgen Schmidt wrote:

On 11/3/10 9:04 AM, Stephan Bergmann wrote:

On 11/03/10 08:30, Jürgen Schmidt wrote:

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

@since OOomajor.minor[.micro],micro   only if   0


care to update
http://wiki.services.openoffice.org/wiki/u...@since_tags  accordingly?

i will do that


http://wiki.services.openoffice.org/w/index.php?title=u...@since_tagsoldid=187533 
still reads:  For UNOIDL documentation, the @since tags are written 
â...@since OOo x.y.z” denoting OOo version x.y.z.


-Stephan

-
To unsubscribe, e-mail: dev-unsubscr...@api.openoffice.org
For additional commands, e-mail: dev-h...@api.openoffice.org



Re: [api-dev] Some consistency in IDL please

2010-10-29 Thread Stephan Bergmann

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/u...@since_tags documents 
which rule to stick to.


-Stephan

-
To unsubscribe, e-mail: dev-unsubscr...@api.openoffice.org
For additional commands, e-mail: dev-h...@api.openoffice.org



Re: [api-dev] Some consistency in IDL please

2010-10-29 Thread Jürgen Schmidt
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/u...@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: dev-unsubscr...@api.openoffice.org
 For additional commands, e-mail: dev-h...@api.openoffice.org
 


-
To unsubscribe, e-mail: dev-unsubscr...@api.openoffice.org
For additional commands, e-mail: dev-h...@api.openoffice.org