[Bug 30098] New: Document synchronous D-Bus property accessors' deprecations more clearly

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=30098

           Summary: Document synchronous D-Bus property accessors'
                    deprecations more clearly
           Product: Telepathy
           Version: git master
          Platform: Other
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: medium
         Component: tp-qt4
        AssignedTo: telepathy-bugs at lists.freedesktop.org
        ReportedBy: will.thompson at collabora.co.uk
         QAContact: telepathy-bugs at lists.freedesktop.org


Our Tp::AbstractInterface subclasses all have deprecated setters and getters
for each D-Bus property on the interface. For instance,
<http://telepathy.freedesktop.org/doc/telepathy-qt4/classTp_1_1Client_1_1ConnectionInterfaceCellularInterface.html#a2a68cb567af20470f4ef77e98b1bdaf2>:

> QString Tp::Client::ConnectionInterfaceCellularInterface::MessageServiceCentre	(		 ) 	 const [inline]
> Getter for the remote object property "MessageServiceCentre".
> 
> Don't use this: it blocks the main loop.
> 
> Returns:
> The value of the property, or a default-constructed value if the property is not readable.

This doesn't tell you why blocking the main loop is bad, or what you should do
instead.

Also, we should stop generating instantly-deprecated API for new interfaces!

-- 
Configure bugmail: https://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.