Since-Version info with ECM macros?

Alex Merry alex.merry at kde.org
Fri Feb 6 09:46:32 UTC 2015


On Thursday 05 February 2015 22:58:24 Friedrich W. H. Kossebau wrote:
> Am Donnerstag, 5. Februar 2015, 12:00:33 schrieb Friedrich W. H. Kossebau:
> > Hi,
> > 
> > I am about to use ecm_add_app_icon, but cannot see which mininmal version
> > of ECM needs to be required to expect this macro to exist.
> > 
> > At least at
> > 
> > 	http://api.kde.org/ecm/module/ECMAddAppIcon.html
> > 
> > there is no hint visible to me. Well, also not in the macro sources
> > itself.
> > 
> > Where would I need to look for that info? Besides git history?
> > 
> > Or is "since-version" tagging something that still needs to be adapted for
> > ECM documentation? :) If so, any proposals how to do that best? Would do
> > the dull work and prepare a patch.
> 
> Or if the plan is to be similar to cmake, simply having API dox online for
> all the released versions online would also a solution, so one can simply
> go through all version until the macro is not documented ;)
> 
> But I would prefer some since-version metadata.

Oh! I hadn't even thought about that - yes, modules should definitely document 
a since-version. Just having a "Since 1.7.0" (or whatever) line in the 
documentation would be fine, I'd have thought. I can do that today.

Alex


More information about the Kde-buildsystem mailing list