Misleading deprecation for tp_cli_channel_type_text_call_list_pending_messages

Submitted by Cosimo Alfarano

Assigned to Telepathy bugs list

Link to original bug (#26494)

Description

The doc for tp_cli_channel_type_text_call_list_pending_messages (ie http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-channel-text.html) defines the method as deprecated:

<quote> tp_cli_channel_type_text_call_list_pending_messages is deprecated and should not be used in newly-written code. Setting this to true is NOT RECOMMENDED for clients that have some sort of persistent message storage - clients SHOULD only acknowledge messages after they have actually stored them, which is impossible if this flag is true </quote>

While actually only passing b:Clear=True is deprecated (according to TP-specs).

A possible correction would be:

---

passing argument in_Clear=TRUE for tp_cli_channel_type_text_call_list_pending_messages is deprecated and should not be used in newly-written code. Setting this to true is NOT RECOMMENDED for clients that have some sort of persistent message storage - clients SHOULD only acknowledge messages after they have actually stored them, which is impossible if this flag is true