Hey, I think this is unneeded as the information it'll provide is redundant. Doxygen documentation already includes the @deprecated (and added API, using @since). It's possible to get it from the docs. I don't think it's needed in the commit message as well.
Since I consider @feature and @fix very important, I'd rather not overwhelm people with a whole set of things, and start it one step at a time. In conclusion: I think we should consider these tags in the future (1.11), but not overwhelm people for 1.10. -- Tom. On Sat, Mar 1, 2014 at 6:54 PM, Davide Andreoli <d...@gurumeditation.it>wrote: > Hi all, > I just finished now to port all the API additions of efl 1.9 to the python > bindings, > it has been quite a hell to go through all the commits to search what has > been added and what has been deprecated. > > So I'm going to propose/ask two more tags for commit messages: @api and > @deprecated > > Usage example for a commit where you added 2 new api and deprecate one: > > @api Elm_Object_Item *elm_object_focused_item_get(const Evas_Object *obj); > @api void elm_object_item_focus_set(Elm_Object_Item *it, Eina_Bool > focused); > @deprecated elm_object_old_function_name(params...); > > This has also the advantage to clarify to all the readers what has been > added at the api level so that we can spot earlier bad designed names and > params. > > The @api tags should also be used for added signals, example: > @api elm_button: "item,unfocused" > > Like the idea? > davemds > > ------------------------------------------------------------------------------ > Flow-based real-time traffic analytics software. Cisco certified tool. > Monitor traffic, SLAs, QoS, Medianet, WAAS etc. with NetFlow Analyzer > Customize your own dashboards, set traffic alerts and generate reports. > Network behavioral analysis & security monitoring. All-in-one tool. > > http://pubads.g.doubleclick.net/gampad/clk?id=126839071&iu=/4140/ostg.clktrk > _______________________________________________ > enlightenment-devel mailing list > enlightenment-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/enlightenment-devel > ------------------------------------------------------------------------------ Flow-based real-time traffic analytics software. Cisco certified tool. Monitor traffic, SLAs, QoS, Medianet, WAAS etc. with NetFlow Analyzer Customize your own dashboards, set traffic alerts and generate reports. Network behavioral analysis & security monitoring. All-in-one tool. http://pubads.g.doubleclick.net/gampad/clk?id=126839071&iu=/4140/ostg.clktrk _______________________________________________ enlightenment-devel mailing list enlightenment-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
