On Tue, May 29, 2012 at 1:26 AM, Vincent Torri <vincent.to...@gmail.com> wrote: > On Tue, May 29, 2012 at 4:07 AM, Daniel Juyung Seo <seojuyu...@gmail.com> > wrote: >> Hello, >> >> On Tue, May 29, 2012 at 6:03 AM, Gustavo Sverzut Barbieri >> <barbi...@profusion.mobi> wrote: >>> On Mon, May 28, 2012 at 5:41 PM, Gustavo Lima Chaves >>> <gl...@profusion.mobi> wrote: >>>> >>>> * Enlightenment SVN <no-re...@enlightenment.org> [2012-05-28 13:35:35 >>>> -0700]: >>>> >>>> > Log: >>>> > [elm] Warn about deprecation of some icon calls >>>> > The ones just wrapping their image counterparts should die eventually. >>>> > The signal callbacks on icons will die, too, eventually. >>>> >>>> Dear people, >>>> >>>> as you can see, I have marked some icon calls as deprecated, since now >>>> it shares a common base with image. Various of its API calls just pass >>>> down the job to the image counterpart, so let's warn users as early as >>>> possible of a future dropping of the icon versions of those. >>> >>> IMO we should be louder and add EINA_DEPRECATED to these things, also >>> marking them in ChangeLog/NEWS for future removal. Maybe we deprecate >>> now (as in EINA_DEPRECATED) and remove in 2.0 or 3.0? >>> >> >> EINA_DEPRECATED makes just warning but I think this is also a kind of API >> break. >> Maybe we create release branch for 2.0 and add EINA_DEPRECATED? > > if it breaks ABI, then the best thing we can do is adding a note in > the documentation using @deprecated: > > http://www.stack.nl/~dimitri/doxygen/commands.html#cmddeprecated > > Having a 2.0 now is too early unfortunately.
Like this? http://trac.enlightenment.org/e/browser/trunk/elementary/src/lib/elm_icon.h#L152 It's impressive people will google for doxygen manual but won't look at our own code :-D -- Gustavo Sverzut Barbieri http://profusion.mobi embedded systems -------------------------------------- MSN: barbi...@gmail.com Skype: gsbarbieri Mobile: +55 (19) 9225-2202 ------------------------------------------------------------------------------ Live Security Virtual Conference Exclusive live event will cover all the ways today's security and threat landscape has changed and how IT managers can respond. Discussions will include endpoint security, mobile security and the latest in malware threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/ _______________________________________________ enlightenment-devel mailing list enlightenment-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
