On 5/29/12 8:22 AM, "ext Jørgen Lind" <[email protected]> wrote:
>Hi >> 6. Rename the handle() to platformXXX() since it's easy to educate >> that anything that has platform in it is out of reach of app >> developers. >> Status: In progress, I am atm, marking handle() as obsolete and as an >> alias to platformXXX(). > >But since when did the word handle() mean anything else in API design? >Im all for clear and verbose function names, but think this is just >making the api ugly. To me if you ask for a handle of a class you will >get the underlying structure. It then should be crystal clear to the >developer that this class can not be used as a public class. The problem is that handle() is very unspecific, and that code ported from Qt 4.x to Qt 5 will silently break when people call handle(), as you get something else back then you thought you would. Renaming the methods at least turns the silent breakage into an explicit one. Cheers, Lars > >Jørgen >_______________________________________________ >Development mailing list >[email protected] >http://lists.qt-project.org/mailman/listinfo/development _______________________________________________ Development mailing list [email protected] http://lists.qt-project.org/mailman/listinfo/development
