How long should we keep deprecated methods?

Radikalizm · Post by **Radikalizm** » Thu Feb 17, 2011 12:37 pm

Brainsaw wrote: I don't know if the current C++ compilers support a "deprecated" warning that points you to deprecated methods you use

The compilers I'm familiar with all do

hybrid · Post by **hybrid** » Thu Feb 17, 2011 2:42 pm

Yes, our deprecation compiler flag does support gcc and MSVC in all usable versions.

Brainsaw · Post by **Brainsaw** » Fri Feb 18, 2011 7:10 am

In that case: seems that I don't use deprecated methods

hybrid · Post by **hybrid** » Fri Feb 18, 2011 9:39 am

Well, the flag also needs to be attached to the method or attribute. So we need to establish consistency between the doxygen deprecation and the code deprecation manually. But yes, there are good chances that no one uses these methods anymore.

agamemnus · Post by **agamemnus** » Mon Feb 21, 2011 2:15 am

hybrid wrote:You can create your own doxygen style as you want and re-run the API creation process locally.

I was just offering my suggestions on some fixes to the documentation, and nothing else. The problems are not so big to hassle myself with changing the documentation (and only for myself?!); someone else who knows a lot more about how the documentation creation program works, and can change the actual irrlicht documentation found online, may be interested in implementing these changes.

Radikalizm · Post by **Radikalizm** » Mon Feb 21, 2011 2:56 am

Take it easy agamemnus, he was just giving you a suggestion, no reason to respond like that

agamemnus · Post by **agamemnus** » Mon Feb 21, 2011 3:27 am

You're right; edited. Hybrid is stealing my suggestion thunder, though.