doxygen-users

[Doxygen-users] doxygen recent versioning

[<JVe...@om...>]

Hello,

I noticed that the last 3 releases of doxygen have all gotten a bump in the middle version number (1.10.0, 1.11.0, 1.12.0).
It seems like a break with tradition of incrementing this relatively rarely and then various increments of the patch version number. E.g. the last one before that was 1.9.8.

I’m interested to know what changed here. Did the definition on when to increment which number change? Or is the way versioning is determined still the same and these are all big updates?
Reason I ask is doxygen upgrades are always some effort for us so seeing these 3 increments of middle number makes me cautious about attempting the next one (we’re currently on 1.9.8.).

Jasper Verelst

Jasper Verelst
Software Expert, Product Development

[phonenumber] +32 3 350 17 27

[mobilenumber] +32 498 01 65 96

jve...@om...
[https://omp.com/Static/img/Disclaimer/Mailsignature_Singapore.png]<https://web-eur.cvent.com/event/c9ec4781-913b-42e2-9b1d-4581db75a95f/summary?RefId=website>


IMPORTANT NOTICE
The information in this e-mail and any attachments is intended for the addressee only. The contents do not represent the opinion of OM Partners n.v. or any of its affiliates except to the extent that it relates to their official business. If you receive this in error, please contact the sender and delete the material from any computer.

Re: [Doxygen-users] doxygen recent versioning

[Liviu I. <il...@li...>]

Hi,

I would add a related question: does doxygen follow the SemVer rules?

Thank you,

Liviu

Re: [Doxygen-users] doxygen recent versioning

[Dimitri v. H. <do...@gm...>]

Hi Jasper,

Doxygen now better follows the semantic versioning scheme.

For version x.y.z: 
- x is incremented only for major changes that break backward compatibility (none planned at the moment). 
- y is incremented for normal backwards compatible updates (large or small) and 
- z is for urgent fixes.

Before 1.10.0, the version scheme was basically 1.x.y (and occasionally 1.x.y.z was used for urgent fixes).

The idea is that .z increments can be made for urgent bugfixes on older releases and released as a branch (not yet needed/used).

We did 1415 commits and changed 569 files since 1.9.8, but if you are happy with the features of 1.9.8 there is no need to upgrade of course ;-)

Regards,
  Dimitri

> On 12 Aug 2024, at 16:20, JVerelst--- via Doxygen-users <dox...@li...> wrote:
> 
> 
> 
> Hello,
>  
> I noticed that the last 3 releases of doxygen have all gotten a bump in the middle version number (1.10.0, 1.11.0, 1.12.0).
> It seems like a break with tradition of incrementing this relatively rarely and then various increments of the patch version number. E.g. the last one before that was 1.9.8.
>  
> I’m interested to know what changed here. Did the definition on when to increment which number change? Or is the way versioning is determined still the same and these are all big updates?
> Reason I ask is doxygen upgrades are always some effort for us so seeing these 3 increments of middle number makes me cautious about attempting the next one (we’re currently on 1.9.8.).
>  
> Jasper Verelst
> 
> Jasper Verelst
> Software Expert, Product Development
> 
>  +32 3 350 17 27
>  +32 498 01 65 96
> jve...@om... <mailto:jve...@om...>
> 
> 
>  <https://web-eur.cvent.com/event/c9ec4781-913b-42e2-9b1d-4581db75a95f/summary?RefId=website>
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
>  
> IMPORTANT NOTICE
> 
> The information in this e-mail and any attachments is intended for the addressee only. The contents do not represent the opinion of OM Partners n.v. or any of its affiliates except to the extent that it relates to their official business. If you receive this in error, please contact the sender and delete the material from any computer.
> 
> 
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li... <mailto:Dox...@li...>
> https://lists.sourceforge.net/lists/listinfo/doxygen-users